GCP默认使用Nginx而非Apache，而.htaccess是Apache特有机制，Nginx完全不解析它；Compute Engine需手动配置Nginx伪静态规则，Cloud Run则须将规则写入容器镜像的nginx.conf，并确保负载均衡器透传查询字符串。
Google Cloud Platform（GCP）上跑 ThinkPHP，默认不支持 .htaccess，必须改用 Nginx 配置，且不能直接套用 Apache 的 RewriteRule。
为什么 GCP 的 Compute Engine 或 Cloud Run 不认 .htaccess
GCP 上主流 PHP 部署方式（如基于 Debian/Ubuntu 的 Compute Engine 实例、Cloud Run 的容器化部署）默认使用 Nginx + PHP-FPM，而 .htaccess 是 Apache 特有的机制，Nginx 完全忽略它。即使你上传了 .htaccess 文件，也不会生效。
- Nginx 不读取或解析
.htaccess—— 这不是权限问题，是设计如此 - Cloud Run 更严格：只接受容器内预定义的入口点和静态配置，不允许运行时动态加载重写规则
- 若强行在 Compute Engine 上装 Apache，需手动启用
mod_rewrite并配置AllowOverride，但违背 GCP 推荐架构，维护成本高
Nginx 配置中必须写的伪静态规则（GCP 实测可用）
在 Nginx server 块中，location / 内添加如下逻辑，核心是把非静态资源请求全部交由 index.php 处理，并正确传递 PATH_INFO：
location / {
try_files $uri $uri/ /index.php?s=$uri&args;
}
-
try_files是 Nginx 原生指令，比if (!-e $request_filename)更高效、更安全 -
/index.php?s=$uri&args中的s是 ThinkPHP 默认识别的 PATH_INFO 入口参数（对应URL_MODEL=2） - 务必保留
&args，否则 GET 参数（如?page=2）会丢失 - 若项目不在根目录（如部署在
/myapp/），需配合alias或调整root，并把/index.php改为相对路径（如/myapp/index.php）
ThinkPHP 侧必须同步调整的配置项
光配 Nginx 不够，ThinkPHP 必须明确告知框架“当前走的是 PATH_INFO 模式”，否则 Route::rule() 或控制器解析会失败：
立即学习“PHP免费学习笔记（深入）”；
- 在
config/app.php中设置：'url_model' => 2（不是URL_MODEL常量，新版已改为配置项） - 确认
config/route.php已启用路由：'url_route_on' => true - 避免混用：不要同时设
'url_html_suffix' => '.html'和url_model = 2，否则生成 URL 时可能多出重复后缀（如/index/index.html/s/xxx） - 开发阶段可临时加
echo $_SERVER['REQUEST_URI'] . ' → ' . ($_SERVER['QUERY_STRING'] ?? ''); die;到public/index.php开头，验证 Nginx 是否真的把路径传进了QUERY_STRING
Cloud Run 容器化部署的特殊处理
Cloud Run 不允许修改运行时 Nginx 配置，所有重写逻辑必须 baked into 容器镜像：
- 在 Dockerfile 中，用
COPY nginx.conf /etc/nginx/sites-available/default替换默认配置 - 确保
nginx.conf包含上述try_files规则，并开启fastcgi_param PATH_INFO $fastcgi_path_info; - 入口命令不能写死
nginx -g "daemon off;"，要加健康检查适配（如监听/healthz返回 200） - 测试时 curl
https://SERVICE-URL/test/123，看是否触发到Index/test控制器，而不是 404 或直接下载index.php
最易被忽略的一点：GCP 的 Load Balancer（尤其外部 HTTP(S) 负载均衡器）默认会 strip 掉 query string 中的 s= 参数，如果用了 HTTPS+LB，必须在 Backend Service 配置里勾选「Include original query string」，否则所有伪静态路由都退化成首页。
