Apache下.htaccess不生效的三个硬性前提是：mod_rewrite模块已启用、AllowOverride设为All、.htaccess文件置于public目录；任一缺失均导致404且无提示。
Apache下.htaccess不生效的三个硬性前提
TP5.1.34 的伪静态不是写完 .htaccess 就能用，必须同时满足三件事：mod_rewrite 模块已启用、AllowOverride 设为 All（不能是 None 或 FileInfo）、.htaccess 文件放在 public 目录（不是项目根目录）。任一缺失都会返回 404，且毫无提示。
常见错误现象：
- 访问
/index/index显示 404，但加/index.php/index/index能正常打开 - 修改了
.htaccess内容，重启 Apache 后完全没反应 - 用
phpinfo()查不到mod_rewrite模块
实操建议：
- 在 phpEnv 或本地 XAMPP 中，进 Apache 设置 → 模块管理 → 勾选
rewrite_module并重启 Apache 进程（仅重载配置无效） - 找到你项目的虚拟主机配置文件（如
phpenv\apache\vhosts\mytp5.conf），手动添加或修改<Directory "D:/phpenv/www/mytp5/public">块，确保含AllowOverride All和Require all granted -
.htaccess必须新建在public/下，内容严格用这个版本（开头结尾无空行、无中文标点）：RewriteEngine On RewriteCond %{REQUEST_FILENAME} !-d RewriteCond %{REQUEST_FILENAME} !-f RewriteRule ^(.*)$ index.php/$1 [QSA,PT,L]
Nginx中location / 里 try_files 和 if 判断的区别
TP5.1.34 在 Nginx 下最稳妥的写法是 try_files，而不是 if (!-e $request_filename)。后者在某些 Nginx 版本中会因变量解析顺序导致 PATH_INFO 丢失，最终路由解析失败，返回空白或 404。
立即学习“PHP免费学习笔记（深入）”；
实操建议：
- 在站点 server 块的
location / { }内，直接替换为：location / { try_files $uri $uri/ /public/index.php?$query_string; } - 紧接着检查 PHP 处理块（通常是
location ~ \.php$）中是否包含：fastcgi_param PATH_INFO $fastcgi_path_info;—— 缺失这行，$_SERVER['PATH_INFO']就为空，TP5.1.34 的路由中间件无法提取路径参数 - 宝塔用户可在「网站 → 设置 → 伪静态」中选择「ThinkPHP 5」，但注意它默认生成的是
/index.php?s=形式；若你的入口是public/index.php，必须手动改成/public/index.php?s=
TP5.1.34 框架层必须开启的三项配置
服务器重写只是第一步，框架本身若没对齐，照样暴露 index.php 或抛出 Route not found。TP5.1.34 默认不强制开启完整路由，需人工确认。
实操建议：
- 打开
config/app.php，确保以下三项存在且为 true：'url_route_on' => true、'url_common_param' => false（避免 GET 参数污染 PATH_INFO）、'pathinfo_depr' => '/'（与 Apache/Nginx 规则中的/$1或?s=$1匹配） - 不要依赖全局
URL_MODEL配置，TP5.1.34 已废弃该常量，改用url_route_on+ 路由定义 - 检查
app/middleware.php是否禁用了think\middleware\ParseUrl，禁用会导致 PATH_INFO 解析跳过，所有路由失效
为什么本地 PHP 内置服务器跑不起来伪静态
PHP 自带的 php -S 不支持 rewrite，也没有 .htaccess 或 nginx.conf 的概念。直接访问 http://localhost:8000/index/index 必然 404，因为请求根本没走到 public/index.php。
实操建议：
- 本地调试时，必须用
public/router.php作为路由器文件：php -S localhost:8000 public/router.php -
public/router.php内容只需一行：require_once __DIR__ . '/../index.php';，它会把所有请求兜底交给 TP 入口 - 别试图在
router.php里手写$_SERVER['PATH_INFO'] = $_SERVER['REQUEST_URI'];—— TP5.1.34 的ParseUrl中间件已自动处理，强行覆盖反而破坏路由优先级
最容易被忽略的是 AllowOverride All 的作用域和 fastcgi_param PATH_INFO 的存在性——前者决定规则是否加载，后者决定规则加载后能否被框架正确消费。这两处错一个，整个伪静态链就断在中间，查日志也看不到明显报错。
