Nginx改了配置却没生效怎么办

配置文件已经保存,执行检查也显示成功,网页却一点没变。这时先确认三件事:请求到的是哪台机器、哪个Nginx进程接收它、这个进程从哪里读取配置。服务器上同时装过系统软件包、面板版或容器版Nginx时,终端里的nginx未必就是正在提供网站服务的那一个。

以下针对Linux中由systemd管理的Nginx。示例服务为nginx.service,HTTPS端口为443;实际名称、端口和路径都要根据查询结果替换。若确认入口在容器或面板中,应回到对应项目的管理入口,不继续操作宿主机的同名服务。

先把监听进程和服务对应起来

sudo ss -ltnp 'sport = :443'
ps -C nginx -o pid,ppid,args --ww
systemctl show nginx.service -p MainPID -p ExecStart -p ExecReload -p FragmentPath

在监听结果中找到程序和PID,再把worker的父进程与nginx: master process对应起来。MainPID应指向这套服务的主进程;ExecStart显示systemd使用的程序和启动参数,ExecReload则说明重载会执行什么。服务不存在、MainPID为0,或者PID对不上时,先查清归属,不能凭服务名相似就重载。

把下例的1234换成确认后的master PID,可以查看运行中的程序文件:

sudo readlink /proc/1234/exe

将结果与ExecStart及进程命令行比较。若路径带有(deleted),可能发生过程序包替换,磁盘上的同名文件未必还是运行中的版本;先核对更新记录和部署方式。多个master并存也不一定是错误,不能直接结束其中一个。

展开这套实例准备读取的配置

只有确认实际路径与下面一致时,才直接使用这组示例。启动参数中存在-p、-c或影响路径的-g设置时,检查命令也要保留对应参数:

sudo /usr/sbin/nginx -V
sudo /usr/sbin/nginx -T -c /etc/nginx/nginx.conf

-V可查看版本和编译时的默认路径;明确的-c会指定另一份主配置,不能只看编译默认值。-T会检查配置,并输出主文件和被包含的文件。输出可能含内部地址、认证头或其他敏感设置,只在受控终端查看,不整份贴到公开工单或截图中。

在输出中的# configuration file标记里找刚编辑的文件。找不到时,检查主配置的include路径、文件后缀是否匹配通配符,以及启用目录中的链接是否指向正确文件。不要仅因为文件放在conf.d或sites-available里,就认定它会被加载。

-T展示的是磁盘文件按本次参数解析的结果,不是运行进程内存中的配置快照。文件内容正确,仍需让正确的master成功重载。

如果文件由面板或发布脚本生成,手工修改可能在下次保存或部署时被覆盖,应找到长期维护的配置来源。备份副本放在网站目录和活跃include目录之外,避免敏感配置被访问,或旧server块被通配符重复加载。配置改完又恢复原样时,应查生成流程,而不是连续重载。

文件加载了,还要确认命中哪个站点

对照真实请求的协议、地址、端口与域名,检查对应的listen和server_name,再看目标路径最终落入哪个location。同时留意检查输出中的重复名称等warning;语法通过不代表请求一定会使用你修改的那一段。

例如改的是80端口站点,但浏览器已经跳转到443;或者访问IP落入默认站点,都可能看不到预期变化。站点选择的基本配置见Nginx多个域名与独立网站。这里不需要新建一套server块来试运气。

通过检查后重载,再验证一条新请求

修改前保存目标配置的副本,确认本轮只包含预期改动,并安排可处理异常的维护时段。以下仍以已经核对的程序、主配置和服务名为例;第一条成功后才执行第二条:

sudo /usr/sbin/nginx -t -c /etc/nginx/nginx.conf &&
sudo systemctl reload nginx.service
sudo systemctl status nginx.service --no-pager
sudo journalctl -u nginx.service --since '5 minutes ago' --no-pager

同时查看这套配置实际指定的error_log。Nginx应用新配置失败时可能继续使用旧配置,因此服务仍然active、页面还能打开,都不足以证明重载成功。旧worker为已有连接完成请求后再退出,短暂并存通常不需要手动清理。

最后新建请求,验证本次具体改动:重定向的目标、页面内容、静态文件或代理接口应与预期一致,并核对对应访问日志。使用CDN或负载均衡时,要分别检查源站和对外入口;指定源站测试的方法见域名未切换时验证新服务器。不要仅靠刷新浏览器判断。

若需要回退,恢复之前保存的目标文件,使用同一套参数检查成功后再重载。检查或重载报错时先保留完整错误,不通过连续restart把配置问题变成停机问题。