根本原因是Composer自动加载未生效;需确保Docker构建时执行composer install、入口文件引入autoload.php、runtime目录权限正确、PHP时区统一配置、FPM与OPcache合理调优。

ThinkPHP容器启动就报 Class 'think\App' not found
根本原因是 Composer 自动加载未生效,不是框架坏了。Docker 内 PHP 运行时找不到 think 命名空间的类,大概率是 vendor/autoload.php 没被引入,或 composer install 在构建阶段没跑成功。
实操建议:
立即学习“PHP免费学习笔记(深入)”;
- 确认
Dockerfile中执行了composer install --no-dev --optimize-autoloader,且在COPY . /app之后(否则复制的是空 vendor) - 检查入口文件(如
public/index.php)是否包含require __DIR__.'/../vendor/autoload.php';,ThinkPHP 6+ 默认有,但若手动删过就得补上 - 别在容器里用
composer install启动时动态装包——既慢又不可控,必须在构建镜像时完成 - 运行容器后执行
docker exec -it your-app php -m | grep opcache,确保opcache已启用,否则自动加载性能会打折扣
容器内日志写不进 runtime/log 目录
典型现象是访问页面空白,php-error.log 里一堆 failed to open stream: Permission denied。不是代码问题,是宿主机挂载目录权限和容器内 UID 不匹配导致的。
实操建议:
立即学习“PHP免费学习笔记(深入)”;
- 不要用
chown -R www-data:www-data runtime/这类命令硬改——容器重启后失效,且不同基础镜像用户 ID 不同(比如php:8.2-apache用www-data,而php:8.2-cli可能没这个用户) - 在
Dockerfile中显式创建 runtime 目录并设宽松权限:RUN mkdir -p /app/runtime/{log,cache,route,view} && chmod -R 777 /app/runtime - 如果用 Docker Compose,避免直接挂载整个项目目录,改用只读挂载源码 + 独立挂载
runtime:volumes: - ./runtime:/app/runtime:rw - ThinkPHP 的
APP_DEBUG设为false后,错误默认不输出到页面,全靠日志,所以这一步卡住会导致“完全没报错却啥也不干”
config/app.php 中的 default_timezone 在容器里不生效
PHP 容器默认时区是 UTC,即使你在 ThinkPHP 配置里写了 'default_timezone' => 'Asia/Shanghai',也仅影响框架内部时间格式化,date()、strtotime() 这些原生函数仍走系统时区。
实操建议:
立即学习“PHP免费学习笔记(深入)”;
- 必须在 PHP 层统一设时区:在
Dockerfile中加RUN echo "date.timezone = Asia/Shanghai" > /usr/local/etc/php/conf.d/timezone.ini - 别依赖
ini_set('date.timezone', ...)—— 容器启动后才执行,中间可能有请求已按 UTC 处理完 - 验证方式:进容器执行
php -r "echo date('Y-m-d H:i:s');",看输出是否为本地时间 - 如果用了 Swoole 或 Hyperf 类扩展,它们有自己的时区配置项,需额外处理,ThinkPHP 的配置管不到那儿
高并发下容器响应变慢,ab 测试 QPS 掉得厉害
不是 CPU 或内存瓶颈,而是 PHP-FPM 子进程数固定、连接队列溢出,或者 OPcache 配置太保守,每次请求都重新编译脚本。
实操建议:
立即学习“PHP免费学习笔记(深入)”;
- 调整
www.conf中的pm.max_children,别照搬官方默认值(如 5)。按公式估算:max_children ≈ (可用内存 - PHP 内存开销) / 每个进程平均内存,一般设成 20~50 更稳妥 - 把
opcache.revalidate_freq=0和opcache.validate_timestamps=0加进 PHP 配置(上线环境),否则每次请求都检查文件修改时间,IO 开销极大 - 禁用
display_errors和log_errors到文件以外的目标(如 syslog),日志刷盘会拖慢响应 - ThinkPHP 的路由缓存(
php think route:cache)必须在构建镜像时生成,不能靠第一次访问触发——否则首屏永远慢
真正难调的其实是 FPM 和 Nginx 之间的连接超时配合,fastcgi_read_timeout 和 pm.response_limit 这类参数稍不匹配,就会出现“偶发 504”却查不出原因。


















