ThinkPHP在Nginx下伪静态不生效，主因是Nginx配置未真实写入加载、root未指向public目录、框架路由未启用三者未对齐；需依次验证配置文件内容、执行nginx -t && nginx -s reload、确认root路径为/public、检查url_route_on=true及错误日志定位Primary script unknown等关键报错。
ThinkPHP在Nginx下伪静态不生效，通常不是单一环节出错，而是Nginx配置、框架设置、路径指向三者未对齐。直接查日志、分步验证比盲目换规则更高效。
检查Nginx配置是否真正写入并加载
宝塔或小皮面板点“保存”不等于配置已生效。需手动确认：
- 打开站点对应的Nginx配置文件（如/www/server/panel/vhost/nginx/your-site.conf），搜索
location /或rewrite，看规则是否真实存在 - 执行
nginx -t验证语法，再运行nginx -s reload重载（宝塔点击“重载配置”，非“重启”） - 若使用子目录（如
/myapp/），确保location /myapp/ { ... }独立存在，且主location /块未覆盖它
确认root指向public目录，而非项目根目录
这是最常被忽略的致命错误。ThinkPHP 6/8 要求Web服务器入口必须是public/目录：
- 配置中
root指令必须明确指向your-project/public，例如：root /www/wwwroot/myapp/public; - 若指向项目根目录（如
/www/wwwroot/myapp），会报Class 'think\App' not found且无提示 - Windows下路径用正斜杠，如
root "D:/www/myapp/public";，引号不能省
验证框架路由开关与参数解析逻辑
Nginx转发过去后，ThinkPHP自身若未启用路由或分隔符不匹配，仍会404：
立即学习“PHP免费学习笔记（深入）”；
- 检查
config/app.php中：url_route_on必须为true，pathinfo_depr必须为'/' -
url_html_suffix设为空字符串''，否则/user/list会被强制要求带.html - 测试时先访问
http://domain/index.php/index/hello——能打开说明框架正常；再试http://domain/index/hello，失败则锁定Nginx层
查看Nginx错误日志定位根本原因
日志里往往一句话就暴露问题所在：
- Windows小皮面板日志路径：
c:\phpstudy_pro\extensions\nginx1.22.1\logs\error.log - Linux宝塔日志路径：
/www/wwwlogs/your-site.error.log - 重点搜索：
Primary script unknown→ root路径错；no such file or directory→ rewrite目标index.php不存在或权限不足
