概叙

科普文：一文搞懂nginx原理和实战_nginx 运行原理-CSDN博客

Java web应用性能分析服务端慢之Nginx慢_nginx 代理慢-CSDN博客

科普文：软件架构设计之【Nginx 实现灰度发布的三种方法总结】_nginx lua实现灰度-CSDN博客

科普文：Nginx 高并发魔法打破性能瓶颈的终极秘籍-CSDN博客

科普文：软件架构设计之【详解Nginx的热加载机制】-CSDN博客

前面讲过nginx热加载，有提到过nginx reload失败、未生效的问题，这篇文章就重点讲一下。

问题一：nginx配置文件配置有误

这个是很常见的，且不容易发现的问题。因为很多时候用“nginx -s reload”来重新加载配置文件时，此时命令不报错。

这个时候，如果查看reload前后Nginx的状态，你就不会发现问题。

为了解决nginx配置文件错误，需要用到“nginx -t ” 或者“nginx -t  ~配置文件”来检查配置文件语法是否合规。

nginx -t 命令说明

nginx -t 命令用于测试 Nginx 的配置文件是否语法正确，并检查配置文件中引用的文件是否存在。如果配置文件没有问题，该命令会输出成功的消息。如果有问题，它会输出错误信息，指出问题所在。

解决方法取决于具体错误信息：

1. 查看错误信息，通常会告诉你错误发生的位置和原因。

2. 根据错误信息，检查相应的配置文件，通常位于 /etc/nginx/nginx.conf 或者 /etc/nginx/conf.d/ 下的文件。

3. 修改配置文件，确保所有指定的文件和路径都是正确的，并且语法无误。

4. 再次运行 nginx -t 检查配置是否通过。

5. 如果通过，重新加载 Nginx 配置以使更改生效，使用命令 nginx -s reload。

例子：

假设你运行 nginx -t 后得到以下错误信息：

nginx: [emerg] unknown directive "wrong_directive" in /etc/nginx/nginx.conf:20

nginx: configuration file /etc/nginx/nginx.conf test failed

你需要打开 /etc/nginx/nginx.conf 文件，找到第 20 行，会发现一个错误的指令 wrong_directive。你需要将它修改为正确的指令，如 listen 或其他合法指令。

修改后，再次运行 nginx -t 确认配置文件没有问题，然后重新加载 Nginx 配置。

问题二：操作nginx.pid文件失败

归根揭底还是“Nginx配置的问题”，当前启动nginx的用户非root用，无权限范围或者创建nginx.pid文件。

通过“service nginx status”查看Nginx状态，会有错误提示

nginx.service: Failed to read PID from file /run/nginx.pid: Invalid argument

 错误原因

经过查询后发现，这个错误是因为nginx和系统之间的竞争引起的。

nginx.pid 文件是在nginx启动时创建的文件，在关闭nginx服务后会消失。

系统在nginx创建该文件前就想要访问这个文件，导致了这个错误的产生。

 解决方案

1.创建nginx.service.d目录

在/etc/systemd/system/目录下创建nginx.service.d文件夹

mkdir /etc/systemd/system/nginx.service.d

2.打印数据到文件

执行下面的命令

printf "[Service]\nExecStartPost=/bin/sleep 0.1\n" > /etc/systemd/system/nginx.service.d/override.conf

3.重新加载daemon服务

systemctl daemon-reload

这将重新运行所有生成器，重新加载所有单元文件并重新创建整个systemd依赖关系树。

4.重启nginx服务

systemctl restart nginx

5.测试

重新测试之前修改过的配置文件是否生效

问题三：配置文件时报错：unknown directive

1.使用./nginx -t 测试nginx.conf配置文件时报错：unknown directive " " in /usr/local/nginx/conf/nginx.conf:3
nginx: configuration file /usr/local/nginx/conf/nginx.conf test failed

原因：nginx.conf的编码格式为：UTF-8-BOM

解决方法：将nginx.conf的编码格式修改为 UTF-8即可。

linux修改文件编码格式utf8
在Linux中，可以使用iconv命令来转换文件的编码格式。如果你想把文件从其他编码转换为UTF-8，可以使用以下命令：

iconv -f [原始编码] -t utf-8 [原文件] -o [新文件]
例如，如果你有一个使用ISO-8859-1编码的文件file.txt，并想把它转换为UTF-8编码，你可以这样做：

iconv -f ISO-8859-1 -t utf-8 file.txt -o file_utf8.txt

小结

当使用nginx reload命令重新加载配置文件时，有时候可能会出现不生效的情况。

这可能是因为配置文件中有语法错误，导致重新加载时nginx无法正常解析配置文件。

解决方法如下：

1. 检查配置文件语法：使用nginx -t命令可以检查nginx配置文件的语法是否正确。如果有错误会显示错误信息，需要根据错误信息进行修正。

2. 查看日志文件：查看nginx的错误日志文件，通常在/var/log/nginx/error.log中，查看是否有相关错误信息提示。

3. 强制重启：如果无法通过reload生效，可以尝试使用nginx -s reload命令强制重新加载配置文件。

4. 检查进程是否存在：使用ps aux | grep nginx命令查看nginx进程是否正常运行，如果没有运行则需要启动nginx服务。

通过以上方法可以解决nginx reload不生效的问题，确保配置文件正确并且nginx进程正常运行即可重新加载配置文件。