Yii2-Nginx API路径访问异常：无法调用/api/web/index.php

我碰到过不少Yii2集成API模块时的路由问题，结合你描述的情况——后台/admin路径正常，API路径失败，大概率是Nginx配置没针对API路径做正确的转发，或者Yii2的路由配置有疏漏。下面是一步步的排查和解决步骤：

1. 优先检查Nginx的路由转发规则 #

Yii2高级版的默认Nginx配置通常只处理了前台（根路径）和后台（/admin）的入口，没有覆盖/api路径。你需要在Nginx配置中添加专门处理/api请求的location块：

# 匹配所有/api开头的请求
location /api {
    # 指向API模块的web根目录，替换成你实际的项目路径
    alias /your-project-path/api/web;
    # 尝试直接访问文件，不存在则转发到index.php
    try_files $uri $uri/ /api/web/index.php?$args;

    # 处理PHP文件的转发
    location ~ ^/api/web/(.+\.php)$ {
        fastcgi_pass php-fpm:9000; # 这里根据你的PHP-FPM服务名/端口调整
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $request_filename;
        include fastcgi_params;
    }
}

添加后重启Nginx服务，测试访问http://yii2-app-advanced.local/api/customer/login看看是否生效。

2. 验证Yii2 API模块的路由配置 #

打开api/config/main.php，检查urlManager的配置是否正确开启了美化URL，并且添加了对应的路由规则：

'components' => [
    'urlManager' => [
        'enablePrettyUrl' => true,
        'enableStrictParsing' => true,
        'showScriptName' => false,
        'rules' => [
            # 确保你的登录路由规则正确
            'POST customer/login' => 'customer/login',
            # 其他API路由规则可以按需添加
        ],
    ],
],

同时确认API模块的控制器（比如CustomerController）存在，并且actionLogin方法已经正确定义。

3. 检查文件权限 #

API模块的api/web目录权限需要和backend/web保持一致，确保Nginx进程能读取该目录下的文件。执行以下命令调整权限（根据你的Nginx运行用户调整www-data）：

chmod -R 755 api/web
chown -R www-data:www-data api/web

4. 借助开发者工具定位错误 #

打开浏览器的开发者工具（F12），切换到Network标签，重新请求API路径，查看返回的状态码：

• 如果是404：说明Nginx没找到API的入口文件，回到第一步检查Nginx配置的路径是否正确；
• 如果是500：查看api/runtime/logs目录下的Yii2日志，里面会有具体的错误信息（比如控制器不存在、路由规则不匹配等）。

5. 测试基础入口是否正常 #

先访问http://yii2-app-advanced.local/api/web/index.php，如果能看到Yii2的默认页面或错误提示，说明入口文件本身没问题，问题出在路由转发；如果这个路径也访问失败，那就是文件路径、权限或者入口文件内容的问题。

内容的提问来源于stack exchange，提问作者Paulo Coutinho