PHP扩展缺失、文件权限错乱、时区字符集未配置、Composer镜像源问题及部署配置疏漏是Docker运行Laravel/ThinkPHP失败的五大主因，需分别通过启用扩展、修正UID权限、显式声明时区与UTF8MB4、切换可信镜像源、严格分离环境配置来解决。
PHP扩展缺失导致框架启动失败
Docker里跑 Laravel 或 ThinkPHP 时，composer install 成功但 php artisan serve 报错“Class not found”或“undefined function openssl_encrypt”，大概率是基础扩展没装全。官方 php:alpine 镜像默认只带最简扩展，pdo_mysql、mbstring、openssl、curl 这几个必须手动启用。
- Alpine 系统用
apk add php7-pdo_mysql php7-mbstring php7-openssl php7-curl（注意版本前缀） - Debian/Ubuntu 基础镜像用
docker-php-ext-install pdo mbstring opcache，再用apt-get install -y libpng-dev libjpeg-dev补图像扩展依赖 - 别在运行时用
pecl install装redis或grpc——编译耗时且易因 Alpine 的 musl libc 报错，优先选预编译包或换php:apache镜像
文件权限错乱引发写入失败
宿主机是 Windows/macOS，容器内 PHP 进程以 www-data（UID 33）运行，但挂载的 ./storage 目录属主是 root 或当前用户，导致日志写不进 storage/logs、缓存生成失败。这不是 Docker 权限“问题”，而是 UID 不对齐的必然结果。
- 开发环境快速修复：启动容器前执行
sudo chown -R 33:33 ./storage ./bootstrap/cache - 更稳妥的做法是在
Dockerfile里用RUN chown -R www-data:www-data /var/www/html/storage，并确保 COPY 进去的目录权限设为755 - Mac 上用 Docker Desktop 挂载时，额外加
:cached（如-v $(pwd):/var/www/html:cached），否则opcache.revalidate_freq失效，改代码不热更
时区与字符集未显式声明
PHP 容器默认时区是 UTC，date() 返回时间比本地快/慢几小时；MySQL 容器若没设 character_set_server=utf8mb4，中文存进去变问号或报错“Incorrect string value”。这两个配置不会自动继承宿主机。
使用 Python 脚本下载 Docker 镜像并打包为 tar 文件。用户说“下载镜像”“拉取镜像”“pull xxx”“帮我下载 nginx 镜像”等时触发。支持 SOCKS5 代理直连（推荐）和国内镜像站加速两种模式。
- 在
php.ini里加date.timezone = Asia/Shanghai，或启动时传-e TZ=Asia/Shanghai并在 Dockerfile 中用RUN ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime - MySQL 启动命令加
--character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci，Laravel 的.env里也要同步设DB_CHARSET=utf8mb4和DB_COLLATION=utf8mb4_unicode_ci - 别依赖
phpinfo()页面查时区——CLI 模式和 FPM 模式可能读不同配置文件，用php -r "echo date_default_timezone_get();"确认 CLI 时区
Composer 依赖安装慢或校验失败
国内直接拉 packagist.org 的包，常卡在 Downloading https://api.github.com/... 或提示 Signature mismatch。这不是网络问题，而是 Composer 2.x 默认启用签名验证，而镜像源（如阿里云）未同步签名密钥。
立即学习“PHP免费学习笔记（深入）”；
- 临时方案：构建时加
RUN composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，但需确认该镜像站已支持签名（2023 年后基本都支持） - 更稳做法：在
composer.json顶层加"config": {"secure-http": false}（仅限内网开发），或用composer install --no-suggest --optimize-autoloader --ignore-platform-reqs跳过平台检查 - CI/CD 构建时记得删掉
vendor和composer.lock缓存——Docker BuildKit 的 layer cache 会误判composer install结果，导致依赖没更新
php-fpm 的 pm.max_children 和 Nginx 的 fastcgi_pass 地址匹配最容易被跳过；还有就是 .env 文件千万别 COPY 进镜像，得靠 docker run -e 或 docker-compose.env_file 注入。 
