ThinkPHP 6.x是官方最新稳定版，所谓“7.1”实为混淆PHP版本（≥7.1）与框架版本；其单入口模式依赖伪静态将请求重写至public/index.php，否则路由无法触发导致404。
ThinkPHP 7.1 并不存在——官方最新稳定版是 ThinkPHP 6.x（截至 2026 年 9 月），所谓 “7.1” 很可能是误传、混淆版本号，或把 PHP 版本（php >= 7.1）错记为框架版本。配置伪静态的逻辑完全基于真实存在的 ThinkPHP 6.x，且必须配合正确的运行目录和 Web 服务器规则。
为什么 Nginx/Apache 必须配伪静态才能访问后台路由
ThinkPHP 6 默认采用「单入口」模式，所有请求都经由 public/index.php 统一调度。如果不配置伪静态，/admin、/api/user/list 这类 URL 会被 Web 服务器当作真实路径查找，直接 404；而伪静态的作用，就是把除静态资源外的所有请求，重写（rewrite）到 index.php 上，交由框架的路由层解析。
- 典型错误现象：
localhost/admin打开空白页或 404，但localhost/index.php/admin能正常访问 - 根本原因：Web 服务器没做重写，框架路由根本没被触发
- 关键前提：Nginx 的
root或 Apache 的DocumentRoot必须指向public/目录，不是项目根目录
Nginx 伪静态规则怎么写才不踩坑
宝塔面板用户直接在网站设置 → 伪静态 → 选择 thinkphp 即可；手动配置时，务必确认 location 块作用于 public/ 目录，且启用 try_files。以下是最简可靠写法：
location / {
try_files $uri $uri/ /index.php?$query_string;
}
- 不要用
if (!-e $request_filename)—— Nginx 官方明确不推荐，易引发 500 或循环重定向 -
$query_string必须保留，否则 GET 参数（如?page=2）会丢失 - 如果项目部署在子目录（如
http://example.com/myapp/），需额外加一层location /myapp/并调整 rewrite 目标
Apache 的 .htaccess 为什么有时不生效
常见于本地 WAMP/XAMPP 或部分 Linux 主机，核心问题是 AllowOverride 未开启或 .htaccess 文件权限受限。
立即学习“PHP免费学习笔记（深入）”；
- 检查 Apache 配置中对应目录的
<Directory>段是否包含AllowOverride All - 确保
.htaccess文件真实存在于public/下，内容为 ThinkPHP 官方标准规则（含RewriteEngine On和RewriteCond判断） - Windows 下文件名可能被系统隐藏为
.htaccess.txt，需显示扩展名并重命名 - 若仍无效，可临时改用
public/index.php入口显式带参数访问，验证是否纯伪静态问题
真正容易被忽略的是：伪静态只是“让 URL 看起来干净”，它不解决路由定义错误、中间件拦截、或控制器方法未声明 public 权限的问题。上线前务必用 php think route:list 确认路由已正确加载，再排查 Web 层转发是否到位。
