Ubuntu下Nginx部署PHP项目返回404错误如何解决？

在Ubuntu系统中使用Nginx部署PHP项目时，遇到404错误是一个常见问题。本文将分析并解决此类问题，以一个具体的案例为例。

问题：开发者在Ubuntu系统上使用Nginx的8088端口部署PHP项目，修改配置文件后仍无法访问，所有接口返回404错误。问题根源在于Nginx配置文件中location块的错误配置，导致Nginx无法正确处理PHP请求。

解决方案：核心问题在于Nginx如何将PHP请求传递给PHP处理程序(PHP-FPM)。以下是一个修正后的Nginx配置文件示例：

server {
    listen 80; # 监听端口，请根据实际情况修改，原文中提到的8088端口在此处未体现
    server_name www.h5fiction1.com;
    root /var/www/h5_fiction_1/public; # 请根据实际项目路径修改，建议使用绝对路径

    location / {
        try_files $uri $uri/ /index.php?$args; #尝试查找文件或目录，若不存在则转发到index.php
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf; #包含fastcgi-php配置
        fastcgi_pass unix:/run/php/php8.1-fpm.sock; #或127.0.0.1:9000，根据PHP-FPM配置修改
    }
}

此配置的关键在于location ~ \.php$块，它定义了如何处理PHP文件。fastcgi_pass指向PHP-FPM的监听地址和端口（此处使用socket方式，更安全高效，请根据你的PHP-FPM配置调整）。try_files指令优先尝试查找静态文件，若不存在则将请求转发到index.php。root指令指定网站根目录，请使用绝对路径并确保其下存在public文件夹及index.php文件。

立即学习“PHP免费学习笔记（深入）”；

重要检查点：

• PHP-FPM: 确保PHP-FPM已正确安装和配置，并正在监听指定的端口或socket。检查PHP-FPM日志以查找错误。
• 权限: 检查Nginx用户对项目文件和目录的读写权限。
• 端口: 确认Nginx监听的端口与配置文件中一致，以及是否与其他服务冲突。 原文中提到的8088端口可能需要在实际配置中修改为80或其他端口。
• 路径: 仔细检查root指令指定的路径是否正确，确保指向项目根目录下的public文件夹（或你的项目入口文件所在目录）。 使用绝对路径可以避免歧义。

通过以上步骤，并仔细检查每个配置项，应该能够解决Nginx部署PHP项目返回404错误的问题。 建议使用try_files指令代替原有的if指令，因为它更简洁高效且易于维护。 同时，使用unix socket连接PHP-FPM比TCP连接更安全和高效。

以上就是Ubuntu下Nginx部署PHP项目返回404错误如何解决？的详细内容，更多请关注php中文网其它相关文章！