UPUPW 下 ThinkPHP 伪静态需同时启用 Apache mod_rewrite 模块、设置 AllowOverride All、开启 ThinkPHP 的 url_route_on 配置，并使用适配 Windows 的 .htaccess 规则，缺一不可。
UPUPW 是 Windows 下轻量级集成环境，内置 Apache + PHP + MySQL，但默认不启用 mod_rewrite 模块，也不自动读取项目根目录的 .htaccess。直接照搬官网或通用 ThinkPHP 伪静态配置，90% 会 404 或跳转到首页。
UPUPW 默认没开 rewrite 模块
UPUPW 的 Apache 配置中，mod_rewrite 是注释掉的，必须手动启用：
- 打开 UPUPW 控制面板 → 点击「Apache 配置」→ 找到
httpd.conf文件 - 搜索
#LoadModule rewrite_module modules/mod_rewrite.so，删掉开头的# - 再搜索
<directory></directory>（路径以你实际安装位置为准），确认其内部包含：AllowOverride All（不是None） - 保存后，必须点击控制面板的「重启 Apache」，否则修改不生效
ThinkPHP 路由配置必须显式开启
UPUPW 不影响 PHP 层逻辑，但 ThinkPHP 默认关闭路由，需在配置中硬性启用：
- 在
config/app.php中确保有这两项（TP5/6 均适用）：'url_route_on' => true'url_html_suffix' => 'html'（可选，设为空字符串则无后缀） - TP6 若用多应用模式，还需检查
config/route.php是否已引入use think\facade\Route; - 别信「只要开了 rewrite 就能用」——
url_route_on关闭时，哪怕 URL 匹配了路由规则，框架也直接走默认解析，不会触发你的Route::rule()
UPUPW 的 .htaccess 写法和 Linux 略有不同
UPUPW 的 Apache 版本较老（常见 2.4.x），且 Windows 路径分隔符敏感，.htaccess 放错位置或写错路径会静默失效：
立即学习“PHP免费学习笔记（深入）”；
-
.htaccess必须放在项目入口文件index.php所在目录（通常是D:/UPUPW/htdocs/your_project/） - 推荐使用这个最小可用版本（适配 TP5/6，兼容 UPUPW）：
RewriteEngine On RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteRule ^(.*)$ index.php/$1 [QSA,PT,L] - 如果项目不在根目录（比如访问地址是
http://localhost/myapp/），必须加RewriteBase /myapp/，否则重写后路径错乱 - 别用
RewriteRule ^(.*)$ /index.php/$1—— 开头的/在 Windows Apache 下容易导致 500 错误
调试时最容易忽略的三个点
UPUPW 下伪静态失败，80% 是卡在这三处：
- 浏览器访问的是
http://localhost/index.php/hello/1，却以为自己在测伪静态 —— 实际应访问http://localhost/hello/1（不带index.php） - 路由定义用了
Route::get('hello/:id', 'index/hello')，但请求是 GET，而浏览器地址栏输错成 POST 表单或 curl -X POST，结果 404 - TP6 启用了「强制路由完整匹配」（
'url_route_must' => true），但route.php里漏写了某条路由，所有未定义路径全 404，连错误提示都没
UPUPW 的本质是封装好的 Apache，它不改 ThinkPHP 的路由逻辑，只放大配置疏漏。真正要调通，得同时盯住 Apache 模块状态、ThinkPHP 路由开关、.htaccess 路径与内容这三层，少一层都白忙。
