Nginx报错汇总帖

一、兼容问题排查（查看执行日志的最后一段可以查看到当前的运行环境）
1.系统未兼容
现在已知的服务器操作系统其实是非常的多的，由于精力有限面板只兼容了一部分主流的服务器操作系统，详情可以参考一下宝塔系统环境支持列表
2.系统架构未兼容
3.修改系统默认内核，如修改为BBR内核版本会引起Nginx、PHP等软件无法正常安装使用。

二、扩展问题
1.configure: error: the HTTP image filter module requires the GD library
Centos：

yum install gd gd-devel

Ubuntu:

apt-get update

apt-get install libgd2-xpm libgd2-xpm-dev  libgd-dev

2.configure: error: the HTTP XSLT module requires the libxml2/libxslt
Centos:

yum -y install libxml2 libxml2-dev libxslt-devel

Ubuntu：

apt-get update

apt-get install libxml2 libxml2-dev libxslt-dev

3.configure: error: BROTLI libs and/or directories were not found where specified!
brotli brotli-devel两个组件需要EPEL源才能安装

yum -y install brotli brotli-devel

Ubuntu:

apt-get update

apt-get install libbrotli1 libbrotli-dev

4.configure: error: the HTTP rewrite module requires the PCRE library.
Centos:

yum -y install pcre pcre-devel

Ubuntu：

apt-get update

apt-get install libpcre3 libpcre3-dev

5.configure: error: C compiler cc is not found
Centos:

yum update

yum -y install gcc gcc-c++ autoconf automake make

Ubuntu:

apt-get update

apt-get install build-essential

6.configure: error: perl module ExtUtils::Embed is required
Centos:

yum -y install perl-ExtUtils-Embed

以上是宝塔面板内安装Nignx常见报错，安装依赖可解决90%问题。后续持续添加Nginx常见安装错误

三、启动报错
1.此问题是某个站点SSL功能导致，关闭报错的中的站点SSL功能即可。然后重新启动Nginx服务

2.Nginx重启提示爆共享内存错误问题，如果有使用到堡塔网站加速插件，在全局配置内调整缓存大小到128M。

3.Nginx服务启动提示lua_package_path错误，可将Nginx服务卸载重新编译，此问题由Nginx付费防火墙的lua模块导致

4.Nginx启动提示Failed(30:Read-only files system)错误，为文件系统只读，在什么没有更改操的情况下报错
有可能是服务器磁盘出问题导致，建议及时备份好数据，联系服务器运营商检查

5.启动提示下面截图，无任何错误的情况下，如安装了Nginx付费或者第三方Nginx免费防火墙，网站监控报表插件和堡塔网站加速插件
可尝试卸载提到的插件，然后重新编译模式安装Nginx。

6.Nginx启动提示pcre_compoile() failed: nothing to repeat in错误，这个是重定向不支持泛域名添加。

7.Nginx启动提示Too many open files错误，出现这个错误可能是由于系统的ulimit限制和nginx自身的配置有关系。需要调整
系统的ulimit句柄数设置，可使用ulimit -n 100001命令临时添加

8.启动提示libgd.so.2错误，命令行执行安装组件重启即可：yum -y install gd gd-devel

9.Nginx提示端口占用，部分服务器会自带Nginx服务或者自行修改其他服务端口导致占用。使用lsof -i:80命令查看占用进程
以及如果网站配置文件内，网站文件配置不当也会导致此错误提示端口占用。则需要检查网站配置内是否有设置其他域名或者IP占用

10，重启或者一键迁移时容易出现的一个错误，nginx提示没有enable-php.conf文件，这个文件是用于记录php版本

解决方法：/www/server/nginx/conf/目录下新建enable-php.conf文件，文件内容为注意：第四行的74代表的是当前nginx使用的php版本，请根据自身情况修改