根本原因是工作目录错误或文件未挂载，需确保 composer.json 在容器 /app 目录下；构建时先 COPY composer.json/lock 再 install；Alpine 需补 curl、unzip、openssl；用官方脚本+SHA384校验安装 Composer；多阶段构建用 COPY --from=builder；开发环境 vendor 应由宿主机生成并挂载。
composer install 在 Docker 容器里失败：找不到 composer.json
根本原因不是 Composer 没装，而是工作目录没对、文件没挂载进去。Docker 默认启动时当前路径是根目录或 /app，但你的 composer.json 很可能在宿主机项目根目录下，没被复制或挂载进来。
实操建议：
- 构建镜像时用
COPY . /app/把composer.json和composer.lock显式拷进去（别只 COPY src/） - 如果用
docker run -v挂载，确保路径映射正确：-v $(pwd):/app，且容器内执行位置是/app - 进容器手动执行
ls -l /app/composer.json确认文件存在，别凭感觉 - 某些基础镜像（如
php:alpine）默认不带curl或unzip，composer install会静默失败——加一句RUN apk add --no-cache curl unzip
PHP 镜像里怎么装 Composer 才不踩坑
官方推荐的 curl -sS https://getcomposer.org/installer | php 方式，在 CI 或多阶段构建里容易因网络或权限出问题；直接用包管理器（如 apt）装的版本又太旧，不支持 composer.lock v2。
实操建议：
- 优先用官方安装脚本 + 校验：先
RUN curl -sS https://getcomposer.org/installer -o composer-setup.php，再RUN php composer-setup.php --install-dir=/usr/local/bin --filename=composer - 跳过验证步骤？别跳。校验哈希能避免中间人攻击或下载损坏——去 https://www.php.cn/link/594ca739e3609243a6b6a3dd8d871114 查最新 SHA384 值，加一行
RUN echo "<hash> composer-setup.php" | sha384sum -c - - Alpine 用户注意：
php命令默认不带openssl扩展，composer install连 HTTPS 包源都会报错——补上RUN apk add --no-cache php82-openssl（按实际 PHP 版本调整）
Dockerfile 里 RUN composer install 的缓存失效太快
每次改一行代码就重跑整个 composer install，构建时间翻倍。问题出在 COPY 顺序：把整个项目目录放在 composer install 之前 COPY，导致只要任意文件变动，缓存就断掉。
实操建议：
- 分两步 COPY：
COPY composer.json composer.lock ./→RUN composer install --no-dev --optimize-autoloader→ 再COPY . . -
--no-dev不只是省空间，还能避免 dev 依赖引入的扩展冲突（比如phpunit依赖的symfony/console版本和主项目打架） - 如果你用的是多阶段构建，最后阶段别再 COPY
vendor/，而是用COPY --from=builder /app/vendor /app/vendor，确保路径完全一致，否则 autoload 会找不到类
写 docker-compose.yml 自动化 PHP+Composer 服务时的硬伤
很多人把 composer install 写进 command:，结果容器一启就卡住、日志没输出、重启后重复执行——因为 command 覆盖了镜像默认的 ENTRYPOINT，而 Composer 不是长期运行进程。
实操建议：
- 把安装逻辑放进自定义 ENTRYPOINT 脚本，而不是 command。例如写个
entrypoint.sh，开头判断[ ! -d "vendor" ] && composer install --no-dev，再 exec “$@” -
depends_on只控制启动顺序，不等 DB 就连不上——别指望它解决“DB 还没 ready 就跑 migration”的问题，得用 wait-for-it.sh 或 dockerize - 本地开发时，别在
docker-compose.yml里配volume挂载整个项目到/app后还让容器自己composer install。vendor 目录权限、符号链接、OSX 文件系统延迟都会导致奇怪的 autoload 错误——开发环境 vendor 应该由宿主机生成并挂载进去
最常被忽略的一点：Composer 的 autoloader 是根据 vendor 目录生成时的文件结构硬编码路径的。容器内外 UID/GID 不一致、挂载卷的 noexec 或 nodev 选项、甚至 Windows 上的 WSL2 文件系统缓存，都可能导致 Class not found 却查不出原因——遇到这种问题，先 php -r "require 'vendor/autoload.php'; var_dump(class_exists('Some\Class'));" 在容器里直跑，比看日志更快定位是不是 autoload 本身坏了。
