伪静态配不成功90%是服务器规则与框架配置未对齐；必须同时满足入口请求正确转发至index.php、PATH_INFO或s参数被识别、路由已开启且定义无误。
伪静态配不成功，90% 不是 ThinkPHP 的问题，而是服务器规则和框架配置没对齐。直接生效的方案必须同时满足三件事：入口请求被正确转发到 index.php、PATH_INFO 或 s 参数能被框架识别、路由本身已开启且定义无误。
Apache 下 .htaccess 规则总不生效？先查这三处
常见现象是写了规则但 URL 仍带 index.php，或直接 404。根本原因往往不是规则写错，而是底层支持缺失：
-
mod_rewrite模块未启用：Linux 执行sudo a2enmod rewrite后必须重启 Apache（sudo systemctl restart apache2）；Windows 需打开httpd.conf，取消#LoadModule rewrite_module modules/mod_rewrite.so注释 -
AllowOverride不是All：在虚拟主机或<directory></directory>块中，必须设为AllowOverride All，设成FileInfo或None时RewriteCond/RewriteRule会被忽略 -
RewriteBase缺失或错误：项目部署在子目录（如/myapp/）时，.htaccess必须加RewriteBase /myapp/，否则重写路径会错位
标准可用规则（注意空格与斜杠方向）：
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ index.php/$1 [QSA,PT,L]
Nginx 中 try_files 比 if 更稳，但 PATH_INFO 必须透传
用 if (!-e $request_filename) 看似简单，但 Nginx 官方明确不推荐在 location 块中使用 if + rewrite 组合，容易触发意外匹配（比如把 /static/css/app.css 也重写进 PHP）。
立即学习“PHP免费学习笔记（深入）”；
可靠写法只有一条：try_files 顺序兜底：
location / {
try_files $uri $uri/ /index.php?s=$uri&$args;
}
但关键在 FastCGI 参数——若漏配或配错，index.php/user/login 这类 PathInfo 路由必 404：
- 必须确保
fastcgi_param PATH_INFO $fastcgi_path_info存在（TP5/TP6 默认需要） - 若用
s参数模式（即/index.php?s=/user/login），则无需依赖PATH_INFO，但框架需设'url_common' => true - 宝塔面板用户注意：默认「ThinkPHP」伪静态模板只适配单应用，多应用必须手动替换为双
rewrite规则
ThinkPHP6 多应用模式下伪静态必须剥离应用前缀
访问 /admin/login 404，但 /index.php/admin/login 正常？这是典型的应用前缀未被 Nginx 透传的信号。
宝塔或手动配置 Nginx 时，不能沿用单应用规则。必须用两条 rewrite 显式剥离应用名：
if (!-e $request_filename) {
rewrite ^/([a-z0-9A-Z_\-]+)/(.*)$ /index.php/$1/$2 last;
rewrite ^/(.*)$ /index.php/$1 last;
}
注意点：
- 正则中的字符集要覆盖实际应用名：含下划线或短横线就加
_\-，否则user_api或api-v1会匹配失败 -
last不能写成break：只有last才会重新发起内部请求，让PATH_INFO正确生成；break会导致url()生成链接丢失应用前缀 - 框架层同步检查：
config/app.php中'app_multi' => true开启，app/multi.php返回合法应用数组，各应用路由不带冗余前缀（如写Route::get('login', ...)，而非Route::get('admin/login', ...)）
子域名伪静态本质是请求转发问题，不是路由问题
子域名（如 admin.example.com）伪静态失败，通常卡在服务器层——请求根本没进到 index.php，框架路由压根没机会执行。
解决逻辑分两层：
- Apache：所有子域名
VirtualHost的DocumentRoot必须指向同一项目根目录（含public/index.php），.htaccess规则通用，但若子域名映射到子目录（如public/admin/），则对应VirtualHost内必须显式设RewriteBase /admin/ - Nginx：每个子域名需独立
server块，root指向项目根目录，并复用相同的try_files规则；若用泛域名（*.example.com），则server_name写~^([a-z0-9\-]+)\.example\.com$，再通过$1变量做应用分流 - 框架内：开启
'url_domain_deploy' => true，用Route::domain('admin.example.com', function () { ... })分组注册路由，否则即使请求进了入口，也会走默认域名逻辑
最易忽略的是：子域名配置后，必须验证 DNS 解析和 HTTPS 证书是否覆盖该子域——Nginx 会因证书不匹配静默拒绝请求，表现就是 404 或连接重置。
