Class 'think\App' not found 错误根本原因是 Composer 自动加载未生效，需在 Docker 构建阶段执行 composer install --no-dev --optimize-autoloader、确保入口文件引入 autoload.php、runtime 目录权限正确、Apache 启用 rewrite 模块且 AllowOverride All、环境变量安全注入。
Class 'think\App' not found 这类错误不是框架坏了，而是容器里根本没装好依赖——一键部署的前提，是构建阶段就跑通 composer install，而不是靠容器启动时临时拉包。
为什么 build 阶段必须执行 composer install
ThinkPHP 6/8 的自动加载完全依赖 vendor/autoload.php。如果 Dockerfile 里只 COPY . . 却没运行 composer install --no-dev --optimize-autoloader，那 vendor 目录就是空的，PHP 运行时自然找不到 think\App。
- 别在
docker-compose.yml的command或entrypoint里补装：既慢（每次重启都重装）、又不可控（网络失败直接挂）、还污染镜像层 - 多阶段构建更稳妥：第一阶段用
php:8.1-cli装依赖，第二阶段用php:8.1-apache只复制vendor和代码，体积小、启动快、无构建工具残留 - 确认是否生效：构建完镜像后，
docker run --rm my-thinkphp-app ls -l vendor/autoload.php应该能列出文件
runtime/storage 权限不能靠 chown -R 硬改
很多 Dockerfile 写 RUN chown -R www-data:www-data runtime storage，这在单次构建时看似有效，但一旦用 volumes 挂载宿主机目录，权限就失效——因为宿主机文件 UID 和容器内 www-data UID 不一致（尤其 macOS/Windows + WSL 场景）。
- 正确做法是在 Dockerfile 中显式创建目录并设宽松权限：
RUN mkdir -p /var/www/html/runtime/{log,cache,route,view} && chmod -R 777 /var/www/html/runtime - docker-compose.yml 中用独立挂载：
volumes: - ./runtime:/var/www/html/runtime:rw，不挂整个项目目录 - 避免用
user: www-data强制切换用户——不同基础镜像用户 ID 不同，容易导致挂载目录不可写
Apache mod_rewrite 和 .htaccess 生效的关键配置
ThinkPHP 的 URL 路由依赖 Apache 的重写模块和 .htaccess 解析，但默认 php:8.1-apache 镜像里 AllowOverride 是 None，.htaccess 直接被忽略。
立即学习“PHP免费学习笔记（深入）”；
- 必须在 Dockerfile 中启用模块：
RUN a2enmod rewrite - 还需覆盖 Apache 默认站点配置：要么在
COPY时替换/etc/apache2/sites-available/000-default.conf，要么在docker-compose.yml中挂载自定义配置文件，并确保其中包含AllowOverride All - 验证方式：
docker exec -it your-app apache2ctl -M | grep rewrite应输出rewrite_module (shared)
环境变量与 .env.docker 的安全注入
生产环境绝不能把数据库密码、API 密钥硬编码进 Dockerfile 或镜像，必须运行时注入。
-
.env.docker文件本身不应进 Git，应通过docker-compose.yml的env_file加载：env_file: .env.docker - ThinkPHP 6+ 支持
Env::get('DB_HOST')直接读取环境变量，无需修改.env文件内容——只要确保变量名和框架默认键匹配（如DB_HOST对应database.hostname） - 注意大小写：Linux 容器中环境变量区分大小写，
db_host和DB_HOST是两个变量
Docker 部署 ThinkPHP 最容易卡住的点，从来不是语法或命令，而是构建时机（composer install 在哪步跑）、权限源头（宿主机 vs 容器 UID）、以及 Apache 配置细节（AllowOverride 是否真生效）。这些地方一错，表现都是“页面空白”或“类找不到”，但原因各不相同。
