ThinkPHP在Docker中伪静态失效的根本原因是Web服务器未正确转发请求至index.php：Nginx需配置try_files与fastcgi_split_path_info支持PATH_INFO，Apache需启用mod_rewrite并设AllowOverride All，.htaccess在Nginx下完全无效。
在 Docker 里跑 ThinkPHP，伪静态失效不是框架问题，而是容器内 Web 服务器没正确转发请求到 index.php —— Nginx 默认不解析 PATH_INFO，Apache 默认不加载 mod_rewrite.so，且 .htaccess 在 Nginx 下根本无效。
ThinkPHP + Nginx 容器必须改 location 配置，不能靠 .htaccess
Nginx 容器根本不读 .htaccess，所有重写逻辑必须写进 server 块。常见错误是直接把 Apache 的 RewriteRule 复制进去，结果 404。
- 确保你的 Nginx 配置中
location /块包含 PATH_INFO 支持逻辑，而不是只匹配.php$ - 推荐用
try_files替代if (!-e $request_filename)，更安全高效 -
fastcgi_split_path_info必须开启，否则$_SERVER['PATH_INFO']为空，ThinkPHP 路由无法识别/article/123这类路径
示例 /etc/nginx/conf.d/default.conf 片段：
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
fastcgi_pass myphp:9000;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_split_path_info ^(.+\.php)(/.+)$;
fastcgi_param PATH_INFO $fastcgi_path_info;
include fastcgi_params;
}
ThinkPHP + Apache 容器要手动启用 mod_rewrite 并允许 .htaccess
Docker 官方 httpd 镜像默认不加载 mod_rewrite.so，也不允许目录级配置，.htaccess 直接被忽略。
立即学习“PHP免费学习笔记（深入）”；
- 构建镜像时需在
Dockerfile中显式启用模块：RUN a2enmod rewrite - 必须覆盖默认的
<Directory /var/www/html>配置，把AllowOverride None改成AllowOverride All或至少AllowOverride FileInfo -
.htaccess文件得放在容器内项目根目录（如/var/www/html/.htaccess），且权限为 644
关键配置片段（写入自定义 000-default.conf）：
<Directory /var/www/html>
AllowOverride FileInfo
Require all granted
</Directory>
ThinkPHP8 的 URL_MODEL=2 在 Docker 里容易失效
TP8 默认关闭 url_route_on，且不再支持旧版 URL_MODEL 配置项。硬写 'URL_MODEL' => 2 不起作用，还会掩盖真实问题。
- 确认
config/route.php中已启用路由：'url_route_on' => true - 检查
config/app.php中'app_host' => ''是否为空；非空值可能导致路由匹配失败 - 如果用了子目录部署（如
http://localhost/tp8/），public/index.php中的define('BASE_PATH', __DIR__ . '/../');没问题，但 Nginx 的root必须指向public/目录，不是项目根目录
Docker 网络和卷映射错误会导致伪静态“看起来生效但实际 500”
常见假象：Nginx 返回 200，但页面空白或报错 “No input file specified”，其实是 PHP-FPM 根本没收到请求，或收到后找不到 index.php。
- 确认 Nginx 容器的
fastcgi_pass地址（如myphp:9000）与 PHP 容器名、端口完全一致，且两容器在同一个自定义网络（--net mynet） - PHP 容器挂载的代码路径（
-v ./src:/var/www/html）必须和 Nginx 的root（如/var/www/html/public）能对上，否则$document_root/index.php路径不存在 - 别用
~ /public/这类模糊路径做 root；明确写绝对路径，比如root /var/www/html/public;
最易被忽略的一点：ThinkPHP 的伪静态依赖于 Web 服务器把原始请求路径完整传给 PHP，而 Docker 环境下任意一层配置漏掉 PATH_INFO 或 QUERY_STRING，都会让路由解析中断 —— 它不报错，只是默默返回首页或 404。
