ThinkPHP URL美化失败主因是服务器未正确转发请求至index.php：Apache需满足AllowOverride All、Options FollowSymLinks及正确RewriteBase三条件；Nginx须在location /与location ~.php$中均配置try_files并传s=$uri&$args，禁用fastcgi_split_path_info，root指向public目录，且框架内url_pathinfo_fetch必须设为's'。
ThinkPHP URL美化失败，90%不是框架没开路由，而是服务器根本没把请求转给 index.php——Apache 没读 .htaccess，Nginx 漏传 s= 参数，或 root 指向错目录，都会导致地址栏死卡 index.php。
Apache 下 .htaccess 不生效的三个硬性条件
光启用 mod_rewrite 不够，必须同时满足三件事：
-
AllowOverride All要写在你项目实际所在的<Directory>块里，比如<Directory /var/www/html/myapp>，不是笼统的/var/www/html - 对应
<Directory>块里必须有Options FollowSymLinks（不能是None或Indexes） -
.htaccess文件得放在 Web 根目录下，且入口文件路径要匹配：如果项目部署在子目录/myapp/，.htaccess开头必须加RewriteBase /myapp/
验证是否生效：执行 apache2ctl -M | grep rewrite，输出必须含 rewrite_module (shared)；再访问一个不存在的路径，看是否 404 还是跳到首页——后者说明重写已工作。
Nginx location / 和 location ~ \.php$ 必须配对
只在 location / 里写 try_files，但 location ~ \.php$ 块里没传参数，请求就进不了 PHP，直接 404。
立即学习“PHP免费学习笔记（深入）”；
-
location /块必须含：try_files $uri $uri/ /index.php?s=$uri&$args; -
location ~ \.php$块里必须显式传递QUERY_STRING：fastcgi_param QUERY_STRING $query_string;（include fastcgi_params不保证包含它） - 禁用
fastcgi_split_path_info——ThinkPHP 不依赖 PATH_INFO，它会把/user/list错拆成/index.php+/user/list，导致路由丢失
常见错误：用 alias 代替 root，结果 $document_root 为空，SCRIPT_FILENAME 构造失败。一律用 root /path/to/public;（结尾不加斜杠）。
ThinkPHP 内部配置不能漏关键项
服务器转发正确后，框架还得知道怎么解析。TP5/6 默认靠 s= 参数，不是 PATH_INFO：
- 确认
config/app.php中'url_pathinfo_fetch' => 's'（不是PATH_INFO或ORIG_PATH_INFO） -
'url_route_on' => true必须开启，否则所有规则都不走 - 若用多语言前缀（如
/zh/news），语言码必须从$_SERVER['REQUEST_URI']用正则提取，不能等路由解析完再判断——否则 SEO 判重复内容
多语言提取示例：preg_match('@^/([a-z]{2}|zh-CN|en-US)(?=/|$)@i', $_SERVER['REQUEST_URI'], $m)，别用 parse_url() 或 explode()，URL 编码或双斜杠会让它们崩。
生成美化链接时最常踩的坑
手动拼接语言切换链接，比如当前是 /zh/news/1，硬加 /en/ 变成 /en/zh/news/1，这是典型路径错位。
- 必须先剥离原始语言段：
$current_path = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH) - 再用正则去掉开头语言前缀，得到干净路径，最后拼新语言码
- 框架助手函数
url()默认不处理语言前缀，需自行封装lang_url($lang, $path)函数
真正难的从来不是写规则，而是确保 Apache/Nginx 的每一层配置都对齐 ThinkPHP 的参数接收方式——少一行 QUERY_STRING，或多一个 fastcgi_split_path_info，整个链路就断了。
