顾佳凯的网络日志 | Failed to parse PID from file /usr/local/nginx/logs/nginx.pid: Invalid argument的解决方案

Failed to parse PID from file /usr/local/nginx/logs/nginx.pid: Invalid argument的解决方案

2023-01-14 #nginx 1439 words 3 min read

问题描述

从源代码安装nginx后，使用如下代码将nginx注册为系统服务。

# 创建服务脚本
vi /usr/lib/systemd/system/nginx.service 

# nginx.service文件内容
[Unit]
Description=The NGINX HTTP and reverse proxy server
After=syslog.target remote-fs.target nss-lookup.target

[Service]
Type=forking
PIDFile=/usr/local/nginx/logs/nginx.pid
ExecStartPre=/usr/local/nginx/sbin/nginx -t -c /usr/local/nginx/conf/nginx.conf
ExecStart=/usr/local/nginx/sbin/nginx -c /usr/local/nginx/conf/nginx.conf
ExecReload=/usr/local/nginx/sbin/nginx -s reload
ExecStop=/usr/local/nginx/sbin/nginx -s stop
PrivateTmp=true

[Install]
WantedBy=multi-user.target

# 重新加载配置文件
systemctl daemon-reload
# 启动nginx服务
systemctl start nginx
# 查看nginx服务状态
systemctl status nginx

下图是我从源代码来安装nginx，并将nginx添加为系统服务后，查看nginx服务状态的效果图。

systemctl status nginx

重点关注倒数第2行，报错信息为nginx.service: Failed to parse PID from file /usr/local/nginx/logs/nginx.pid: Invalid argument。意思是从文件/usr/local/nginx/logs/nginx.pid中解析PID失败。

而路径/usr/local/nginx/logs/nginx.pid，在nginx.service文件[Service]区块中定义过：PIDFile=/usr/local/nginx/logs/nginx.pid，路径没有错误，这让我摸不着头脑。

stackoverflow上有关于类似问题的讨论：centos 7: nginx Failed to read PID from file /run/nginx.pid: Invalid argument。

一共有两个回答，第一个回答说可以忽略日志中的警告（确实可以忽略，因为这个错误并没有导致nginx运行异常）；第二个回答说重启服务器解决了问题，于是我也重启服务器，但是当我重启完服务器后，查看nginx状态时，发现报错信息变成了nginx.service: New main PID does not exist or is a zombie.，意思是新的主进程ID并不存在或者是一个僵尸进程。于是我又重启nginx服务，当我重启完后，新的报错信息又变为了一开始遇到的报错信息：nginx.service: Failed to parse PID from file /usr/local/nginx/logs/nginx.pid: Invalid argument。

解决方案

最后我结合以下3个网页解决了遇到的问题。

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

Nginx.service: failed to parse pid from file /run/nginx.pid: invalid argument

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

解决措施：在nginx.service文件[Service]区块中新增一行ExecStartPost=/bin/sleep 0.1。意思是在systemd启动nginx服务后睡眠0.1s，以保证nginx服务启动完成并已经创建完PIDFile，这样子systemd去读取nginx的pid时，就不会造成读取失败的情况。

注意下面带+号的新增代码。

# 创建服务脚本
vi /usr/lib/systemd/system/nginx.service 

# nginx.service文件内容
[Unit]
Description=The NGINX HTTP and reverse proxy server
After=syslog.target remote-fs.target nss-lookup.target

[Service]
Type=forking
PIDFile=/usr/local/nginx/logs/nginx.pid
ExecStartPre=/usr/local/nginx/sbin/nginx -t -c /usr/local/nginx/conf/nginx.conf
ExecStart=/usr/local/nginx/sbin/nginx -c /usr/local/nginx/conf/nginx.conf
+ ExecStartPost=/bin/sleep 0.1
ExecReload=/usr/local/nginx/sbin/nginx -s reload
ExecStop=/usr/local/nginx/sbin/nginx -s stop
PrivateTmp=true

[Install]
WantedBy=multi-user.target

# 重新加载配置文件
systemctl daemon-reload
# 启动nginx服务
systemctl start nginx
# 查看nginx的状态
systemctl status nginx
# 开机自启
systemctl enable nginx.service

关于服务脚本内容解释

# 定义启动顺序与依赖关系。
[Unit]
# 当前服务的简单描述。
Description=The NGINX HTTP and reverse proxy server
# 启动顺序。
After=syslog.target remote-fs.target nss-lookup.target

# 定义如何启动当前服务。
[Service]
# 定义启动类型。
Type=forking
# 采用引用服务的 PID 文件的路径。
PIDFile=/usr/local/nginx/logs/nginx.pid
# 启动服务之前执行的命令，-t表示测试配置并退出，-c用于指定配置文件。
ExecStartPre=/usr/local/nginx/sbin/nginx -t -c /usr/local/nginx/conf/nginx.conf
# 定义启动进程时执行的命令，-c用于指定配置文件。
ExecStart=/usr/local/nginx/sbin/nginx -c /usr/local/nginx/conf/nginx.conf
# 启动服务之后执行的命令，在systemed读取PID文件前，让systemd睡眠0.1s。
ExecStartPost=/bin/sleep 0.1
# 重启服务时执行的命令，-s用于给出主进程发送信号。
ExecReload=/usr/local/nginx/sbin/nginx -s reload
# 停止服务时执行的命令，-s用于给出主进程发送信号。
ExecStop=/usr/local/nginx/sbin/nginx -s stop
# 如果为true，则为执行的进程设置一个新的文件系统命名空间，并在其中挂载一个私有/tmp 目录，
# 命名空间之外的进程不会共享该目录。
# 这对于保护对进程临时文件的访问非常有用，但是无法通过/tmp 在进程之间共享。默认为 false。
PrivateTmp=true

# 定义如何安装这个配置文件。
[Install]
# 表示该服务所在的 Target。
WantedBy=multi-user.target