Nginx编译安装时常见错误分析

这篇文章主要是关于Nginx在编译安装时,可能出现的错误的解决方法。
1 Nginx启动脚本错误:env: /etc/init.d/nginx: No such file or directory

明明上传了Nginx服务控制脚本 nginx ,但是在执行 service nginx start 命令时,却会报上面的错误。

解决方法:启动脚本的格式有问题,例如该脚本是dos格式,在Linux系统是中无法识别的。可以通过vim打开该文件,如果可以看到出现 ^M 的字符,就可以确定是DOS格式的了。那么可以在vim中执行命令 :%s/\r\+$//e ,将其转换成Unix格式即可。

2 启动Nginx服务失败

安装完Nginx后,执行命令 service nginx start 失败,即无法正常启动Nginx服务。

[root@typecodes init.d]# service nginx start
Starting nginx (via systemctl):  Warning: Unit file of nginx.service changed on disk, 'systemctl daemon-reload' recommended.
Job for nginx.service failed. See 'systemctl status nginx.service' and 'journalctl -xn' for details.
[FAILED]

解决方法:主要通过命令 systemctl status nginx.service 来分析,如下图所示。

很明显是由于下面这个错误,导致Nginx服务启动失败。
Apr 11 21:43:07 typecodes nginx[4026]: Starting nginx: nginx: [emerg] mkdir() "/var/tmp/nginx/client/" failed (2: No such file or directory)

这种错误一般都是目录不存在或者权限不足,所以直接执行下面两条命令即可。
[root@typecodes ~]# cd /var/tmp/
[root@typecodes ~]# mkdir -p /var/tmp/nginx/{client,proxy,fastcgi,uwsgi,scgi}

3 启动Nginx服务时,界面卡住

在敲入命令 service nginx restart 后,终端界面能卡住,也就是Nginx服务控制脚本 nginx 没有正常执行完毕。在停止Nginx服务后,发现Nginx进程还存在。

#######启动Nginx服务出现警告
[root@typecodes init.d]# service nginx restart 
Restarting nginx (via systemctl):  Warning: Unit file of nginx.service changed on disk, 'systemctl daemon-reload' recommended.
Restarting nginx (via systemctl):  Warning: Unit file of nginx.service changed on disk, 'systemctl daemon-reload' recommended.
^C     ######终端界面卡住,使用ctrl+c命令强制结束

#######停掉Nginx服务
[root@typecodes init.d]# service nginx stop
Stopping nginx (via systemctl):  [  OK  ]

#######查看Nginx进程是否已被停止(可以看到未停止)

[root@typecodes init.d]# ps -aux|grep nginx 
root      7796  0.0  0.2  84184  2044 ?        Ss   21:14   0:00 nginx: master process /usr/sbin/nginx -c /etc/nginx/nginx.conf
nginx     7798  0.0  0.3  86656  3380 ?        S    21:14   0:00 nginx: worker process
root      7981  0.0  0.0 112644   964 pts/0    S+   21:19   0:00 grep --color=auto nginx

解决方法:可能是Nginx服务控制脚本(/etc/init.d/nginx)代码不正确,推荐使用文章 《Nginx服务启动、停止和重启等操作的SHELL脚本》 中的shell脚本。最后再重新执行下面的脚本即可。

[root@typecodes init.d]# chkconfig --add nginx
[root@typecodes init.d]# chkconfig nginx on
[root@typecodes init.d]# service nginx restart

还有一种在启动Nginx服务时,终端界面会卡住的情况:那就是Nginx的配置文件 /etc/nginx/nginx.conf 不正确,但是使用 nginx -t 命令显示正常。这种情况只能对nginx.conf文件中的每一个配置进行检查了。

4 Compilation failed in require或者perl_parse() failed

在使用命令 service nginx start 启动Nginx服务时报错,于是通过 systemctl status nginx.service 查看具体的错误信息。

然后使用命令 nginx -t 查看配置是否正常,如下图所示,同样报错。

解决方法:从图中可以看出由于 Can't load '/usr/local/lib64/perl5/auto/nginx/nginx.so' for module nginx: /usr/local/lib64/perl5/au...m line 68. 的错误,导致了Nginx在调用函数时失败: perl_parse() failed 。也就是证明是之前没有安装perl依赖包,于是通过执行命令 yum -y install perl-devel perl-ExtUtils-Embed 后,再次编译安装Nginx解决。

点赞