ThinkPHP容器化部署核心卡点是public目录定位、runtime权限、Nginx路由转发、环境变量注入四者未对齐；Nginx 404主因是root未设为/var/www/html/public或SCRIPT_FILENAME路径拼错；Class 'think\App' not found源于vendor未安装或autoload未引入；Permission denied需用chmod 777预设runtime目录并拆分挂载；.env必须运行时通过env_file注入根目录。
ThinkPHP 容器化部署不是“写个 Dockerfile 就能跑”，核心卡点在 public 目录定位、runtime 权限、Nginx 路由转发、环境变量注入 四处。其他环节出错，往往只是这四点没对齐的表象。
为什么 Nginx 容器里 try_files $uri $uri/ /index.php?$query_string 仍 404
最常见原因是 root 没指向 public 目录，或 location ~ \.php$ 块里 SCRIPT_FILENAME 拼错了路径。
-
root必须设为/var/www/html/public（不是项目根目录），否则/index.php找不到 -
try_files后必须带$query_string，否则?s=api/user这类参数会丢失 -
fastcgi_param SCRIPT_FILENAME必须是$document_root$fastcgi_script_name，不能写成$realpath_root或漏掉$document_root - 别复制 Apache 的
.htaccess规则到 Nginx 配置里——语法不兼容，RewriteRule在 Nginx 里直接报错
Class 'think\App' not found 是什么问题
这不是框架坏了，而是自动加载失效。根本原因只有两个：vendor 没装上，或入口文件没引入 autoload。
- 确认
Dockerfile中composer install --no-dev --optimize-autoloader在COPY . .之后执行，否则 vendor 是空的 - 检查
public/index.php开头是否有require __DIR__.'/../vendor/autoload.php';（ThinkPHP 6+ 默认有，但定制镜像可能删过） - 别在
ENTRYPOINT里运行composer install——构建时就该确定依赖状态，运行时装包不可控且慢 - 用
docker exec -it your-app php -m | grep opcache确认 opcache 已启用，否则类加载性能极差
file_put_contents(/runtime/) Permission denied 怎么解
权限错误不是 chmod 一下就能好，关键是容器用户 UID 和宿主机挂载目录的属主是否对得上。
立即学习“PHP免费学习笔记（深入）”；
- 不要在宿主机上跑
chown -R www-data:www-data runtime/——不同基础镜像的www-dataUID 不同（比如 Alpine 镜像里压根没有这个用户） - 推荐做法：Dockerfile 中提前建目录并设宽松权限：
RUN mkdir -p /var/www/runtime/{log,cache,route,view} && chmod -R 777 /var/www/runtime - 挂载时拆开：
-v $(pwd)/public:/var/www/html:ro -v $(pwd)/runtime:/var/www/runtime:rw，避免整个项目目录被挂载导致敏感路径暴露 - 如果用 Docker Compose，确保
runtime挂载路径和容器内TP_RUNTIME_PATH环境变量一致（如设为/var/www/runtime）
.env 文件怎么安全注入容器
.env 绝不能打进镜像，也不能靠 COPY 放进容器——它含数据库密码等凭证，必须运行时注入。
-
.env必须放在项目根目录（即/var/www下），因为 ThinkPHP 默认只读取那里；而你挂载的public是子目录，根目录可能未挂载或不可写 - 用
docker-compose.yml的env_file字段注入：env_file: [".env"]，或更安全的secrets - 若用
-e DB_HOST=xxx方式传参，.env中要写DB_HOST=${DB_HOST}，并确认 PHP 的putenv()可用（某些 Alpine 镜像默认禁用） - 验证是否生效：进容器执行
php think env:show（需安装think-command插件）或var_dump(Env::get('database.hostname'))
真正难的不是配置本身，是所有环节必须严丝合缝：Nginx 的 root 和 PHP 的 TP_RUNTIME_PATH 指向不同目录、.env 在根目录却没挂载进去、runtime 挂载了但权限锁死——任何一个断点，都会让整个应用静默失败。
