根本原因是composer.lock记录的平台约束（PHP版本、扩展）与容器实际环境不一致；需检查lock文件platform字段，确保Docker镜像启用对应扩展，并在目标PHP版本下运行composer update --lock后提交，禁用--ignore-platform-reqs避免掩盖问题。
composer install报“Your requirements could not be resolved”
根本原因是composer.lock里记录的平台约束（PHP版本、扩展）和容器实际环境不一致。比如composer.lock顶部有"platform": {"php": "8.2"}，但Docker镜像用的是PHP 7.4，Composer就会拒绝安装。
检查方法：打开composer.lock，搜platform字段；没声明时，Composer会按当前PHP环境推断并锁死，导致跨环境构建失败。
- 构建前先在目标PHP版本下跑
composer update --lock，再提交更新后的composer.lock - Dockerfile中确保提前启用必需扩展：
RUN docker-php-ext-install pdo mbstring zip - 别用
composer install --ignore-platform-reqs绕过——它掩盖问题，上线后可能因缺少扩展直接崩
卡在“Resolving dependencies”或超时
本质是网络+缓存双重失效：Docker构建无法复用宿主机的Composer缓存，又默认直连packagist.org，国内访问极慢甚至DNS解析失败。
验证是否DNS问题：进容器执行ping packagist.org或curl -v https://packagist.org；若不通，优先查Docker DNS配置。
- 构建时换国内镜像源：
COMPOSER_REPO_PACKAGIST=https://mirrors.aliyun.com/composer/ composer install - 确保
COPY composer.lock .在COPY composer.json .之后、composer install之前——否则Composer会退化成update，重新算依赖树 - 避免
COPY . .后再装依赖，否则改一行代码就重跑整个composer install
报“Permission denied”或“failed to open stream”
核心矛盾是宿主机挂载目录的UID/GID和容器用户不匹配。macOS/Windows挂载卷丢失文件属主信息，容器内root写的vendor/回到宿主机就变成只读，IDE或git操作全报错。
使用 Python 脚本下载 Docker 镜像并打包为 tar 文件。用户说“下载镜像”“拉取镜像”“pull xxx”“帮我下载 nginx 镜像”等时触发。支持 SOCKS5 代理直连（推荐）和国内镜像站加速两种模式。
别用sudo docker run或容器内sudo composer install——这会让vendor/属主变成root，后续谁都改不了。
- 查宿主机UID/GID：
id -u和id -g（常见是1001:1001） - 运行时显式传参：
composer install --uid=1001 --gid=1001 - docker run加
--user 1001:1001，docker-compose.yml里用user: "${UID:-1001}:${GID:-1001}"，别硬编码 - 如果只是临时调试，删掉
vendor/和composer.lock重来，比修权限更快
容器里找不到composer命令或ext-zip missing
官方PHP镜像（如php:8.3-cli）默认不含Composer二进制，也不启用zip扩展——而Composer下载包必须用它解压。
现象：/bin/sh: 1: composer: not found 或 The requested PHP extension zip is missing。
- 用官方安装脚本装Composer：
RUN curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer - 启用必要扩展：
RUN docker-php-ext-install zip mbstring openssl（不是apt-get） - 设
COMPOSER_HOME并修复权限：ENV COMPOSER_HOME=/tmp/composer && RUN mkdir -p $COMPOSER_HOME && chmod 777 $COMPOSER_HOME - 运行时加
--no-interaction，避免交互式提示卡住
真正麻烦的从来不是某一条报错，而是多个问题叠在一起：PHP版本不对 + 镜像没装zip扩展 + 宿主机UID没对齐 + 还用了--ignore-platform-reqs强行跳过……结果就是本地能跑，CI失败，上线崩溃。拆开一个个验，比猜快得多。
