ThinkPHP 8.1在宝塔9.0中伪静态不生效或报冲突，核心是配置层级冲突与路径指向错误；必须设运行目录为/public、选thinkphp6模板、禁用防跨站和PHP隔离，并统一用try_files $uri $uri/ /index.php?$query_string;规则。
ThinkPHP 8.1 在宝塔 9.0 中伪静态不生效或报冲突，核心不是版本不兼容，而是宝塔自动生成的 Nginx 配置（尤其是反向代理、PHP 处理块、防跨站等）与你手动添加的 ThinkPHP 伪静态规则发生层级覆盖或逻辑互斥。TP8.1 路由机制延续 TP6+ 的 s 参数模式，强烈推荐弃用 if + rewrite，统一采用 try_files 方式，并确保整个请求链路路径指向正确。
宝塔 9.0 下 ThinkPHP 8.1 必须匹配的三项基础配置
网站根目录必须设为
public/子目录
进【网站】→【设置】→【网站目录】→「运行目录」选/public（不能是/或留空）。否则$uri匹配不到静态资源，CSS/JS 全 404，连入口文件都加载失败。伪静态模板必须选
thinkphp6（非 thinkphp5 或自定义旧规则）
TP8.1 默认路由模式与 TP6 完全一致（?s=home/index），宝塔thinkphp6.conf模板已内置适配try_files $uri $uri/ /index.php?$query_string;。选错模板会导致规则注入错误位置或缺失关键指令。禁用「防跨站攻击」和「PHP 版本隔离」开关
这两个功能会自动在location ~ \.php$前插入额外location /或重写逻辑，极易覆盖或拦截你配置的主location /块。进【网站】→【PHP 设置】→ 关闭这两项。
如何确认并清除模板冲突
宝塔 9.0 保存伪静态后，会把规则写入站点配置文件（如 /www/server/panel/vhost/nginx/your-site.conf）。但若之前启用了反向代理、SSL 或手动编辑过配置，可能出现以下典型冲突：
修复 Core bailout 状态损坏安全问题，以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
现象：保存伪静态后提示“配置冲突”
表明宝塔检测到location /内同时存在proxy_pass和try_files（它认为互斥）。
✅ 解法：清空【伪静态】输入框 → 进【反向代理】→ 把try_files规则粘贴到「配置文件」文本框里（注意不要带location / { }外壳，只填内部语句），再保存。现象：Nginx 启动成功，但访问仍 404 或跳首页
执行nginx -t确认语法无误后，打开该站点配置文件，搜索location /，检查是否出现 两段location /：一段是宝塔自动生成的（含proxy_pass或index index.php），另一段是你通过伪静态添加的（含try_files）。
✅ 解法：保留且仅保留一段location /，将try_files $uri $uri/ /index.php?$query_string;直接写入其中，并删掉重复的location /块。现象：页面能打开，但路由参数丢失（如
/user/list变成/index.php）
多半是fastcgi_param SCRIPT_FILENAME路径拼错了。检查 PHP 处理块中是否有这行：fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
❌ 错误写法：$realpath_root（宝塔某些模板残留）、$root（Nginx 不识别）、或$document_root指向了项目根而非public/。
✅ 正确做法：确保root指令在server块顶层已明确设为root /www/wwwroot/your-site.com/public;，这样$document_root才等于真实路径。
TP8.1 特别注意事项（绕过 PATH_INFO 依赖）
TP8.1 默认启用 url_common_param = 's'，即靠 $_GET['s'] 解析路由，不强制依赖 PATH_INFO。因此：
- 彻底删除所有
fastcgi_split_path_info相关行（宝塔模板有时会带）； - 不需要配置
fastcgi_param PATH_INFO $fastcgi_path_info;（加了反而可能干扰）； -
php.ini中cgi.fix_pathinfo=1保持开启即可（默认值，勿改）； - 若调试时想强制生效，可在
public/index.php开头临时加一行（上线前务必删）：$_GET['s'] = $_SERVER['REQUEST_URI'];
配置完成后，执行：nginx -t && nginx -s reload
再清空 runtime/log/ 和 runtime/cache/ 目录（权限需为 www 用户可写），重启生效。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
