Apache环境下.htaccess必须启用mod_rewrite
ThinkPHP的URL重写依赖Apache的重写模块，如果没开，所有重写规则都无效，访问带index.php的URL能打开，去掉就404——这是最常卡住的地方。
确认方式：运行apache2ctl -M（Linux）或查看httpd.conf里是否启用了LoadModule rewrite_module modules/mod_rewrite.so，且对应<directory></directory>段落中AllowOverride设为All，不是None。
Windows XAMPP默认已开启，但虚拟主机配置可能覆盖它宝塔面板需在网站设置 → 伪静态 → 选择“ThinkPHP”模板，别手写漏了RewriteBase /如果项目不在根目录（比如放在/myapp/），RewriteBase必须改成/myapp/，否则重写后路径错乱
ThinkPHP 6 的url_html_suffix和url_domain_deploy不是万能开关
很多人以为只要在config/app.php里把url_html_suffix设为空、url_domain_deploy设为true就能自动隐藏index.php，其实这两个配置只影响URL生成逻辑，不控制服务器重写行为。
真正起作用的是Web服务器配置（.htaccess或Nginx配置）+ ThinkPHP路由是否开启force模式。
立即学习“PHP免费学习笔记（深入）”；
url_html_suffix为空只让url()函数不加.html后缀，跟入口文件无关url_domain_deploy是为多应用域名部署准备的，比如admin.example.com自动绑定admin模块，和重写无关若用php artisan serve本地调试，它根本不支持重写，必须换Apache/Nginx
Nginx配置里try_files顺序错了会直接500
Nginx没有.htaccess机制，必须在server块里显式配置重写。常见错误是把try_files写成try_files $uri $uri/ /index.php，漏掉$args，导致GET参数丢失，比如?id=123进不了index.php。
正确写法必须保留查询参数传递：
location / { try_files $uri $uri/ /index.php?$query_string;}不能写/index.php?S=——那是ThinkPHP 5.0的老写法，TP6已废弃如果用fastcgi_split_path_info方式，要确保SCRIPT_FILENAME指向真实index.php路径，否则报File not found部分云服务器（如腾讯云轻量）默认Nginx配置含location ~ \.php$块，需确认该块是否被上面的location /覆盖
TP6路由domain绑定和bind配置容易和重写冲突
当你用Route::domain(‘api.example.com’, function () {…})时，ThinkPHP会在内部做域名匹配，但如果Nginx/Apache没把该域名解析到正确目录，或者SERVER_NAME被代理层修改过（比如CDN、负载均衡），路由就永远匹配不上。
更隐蔽的问题是：如果在route/app.php里用了Route::bind(‘admin’)，又同时配置了子域名，而入口文件路径没对齐，index.php可能被重写多次，最终404。
先确认$_SERVER[‘HTTP_HOST’]输出是否是你期望的域名，不是localhost或IPCDN场景下，需在Nginx里加fastcgi_param HTTP_HOST $host;，否则TP6读不到原始域名bind只影响URL解析，不影响重写；但如果你把admin绑到admin/前缀，又配了admin.example.com，两者逻辑要自洽，否则用户访问admin.example.com/user却进了index/index模块域名重写本身不难，难在每层环境（DNS、CDN、反代、Web服务器、PHP SAPI、框架路由）都得对得上，漏一个环节，index.php就藏不住。尤其注意$_SERVER变量在不同部署下的真实性——它经常被中间件悄悄改掉。
评论(0)