ThinkPHP 6 访问路由报 404 pathinfo 和伪静态怎么配

现象

ThinkPHP 6 项目本地用 php think run 跑得好好的,部署到 Nginx 之后访问 /index/artiCle 直接 404,换成 /index.php/index/article 又能打开。打开 APP_DEBUG 后提示控制器不存在,或者直接返回 Nginx 的 404 页面。

原因

Nginx 没有把不存在的路径交给 index.php 处理,PATH_INFO 也没有传下去,框架自然收不到路由;TP6 默认不开启强制路由,多应用模式下没装 think-multi-app,路由文件不会被加载;站点根目录指向了项目根而不是 public 目录,入口路径就多出一层;runtime 里残留旧的路由缓存也会导致新路由不生效。

解决步骤

第一步,把站点根目录指到 public。Nginx 的 root 必须指向 public 目录,指向项目根会让入口和静态资源路径全部错位。

location / {
    try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
    fastcgi_pass unix:/tmp/php-cgi-80.sock;
    include fastcgi_params;
}

第二步,检查多应用模式是否开启。使用 app 目录分应用时,需要通过 composer 安装 think-multi-app,并在配置里打开多应用,否则 /index/article 这种带应用名的地址会被当成单应用下的控制器。

第三步,清掉路由与模板缓存。删除 runtime 下的缓存文件,重启 PHP-FPM,再访问一次让框架重新生成。

验证

直接访问 /index/article 返回 200,APP_DEBUG 打开后能看到正常的路由匹配信息,分页、参数传递都正确,日志里不再出现控制器不存在的异常。

小结

TP6 的 404 大多发生在 Nginx 层,先确认 root 指向 public、try_files 交给 index.php,再检查多应用与路由缓存,顺序清楚了排查很快。

您可以还会对下面的文章感兴趣: