nginx的server_names_hash_bucket_size问题

千家信息网最后更新 2026年11月01日nginx的server_names_hash_bucket_size问题

之前nginx可以正常启动的，后来为了测试方便，就增加多了一些域名也都转向到相同的upstream里面，启动不起来。

去logs/errors.log查看，发现如下字样：

could not build the server_names_hash, you should increase server_names_hash_bucket_size: 32

原来是由于增加多域名后，在默认大小下已经不能正常hash存储了，需要去修改此参数的大小。

修改conf/nginx.conf中的http节为如下示例

http {

server_names_hash_bucket_size 64;

include mime.types;

default_type application/octet-stream;

.....省略

此处为了以后增加方便，没有直接修改为日志中提示的32大小，而是直接修改为64了

再次启动，正常运行

下面是在中文wiki上摘抄的一段说明
　　保存服务器名字的hash表是由指令 server_names_hash_max_size 和 server_names_hash_bucket_size所控制的。参数hash bucket size总是等于hash表的大小，并且是一路处理器缓存大小的倍数。在减少了在内存中的存取次数后，使在处理器中加速查找hash表键值成为可能。如果 hash bucket size等于一路处理器缓存的大小，那么在查找键的时候，最坏的情况下在内存中查找的次数为2。第一次是确定存储单元的地址，第二次是在存储单元中查找键 值。因此，如果Nginx给出需要增大 hash max size 或 hash bucket size的提示，那么首要的是增大前一个参数的大小.