根本原因是官方php镜像（如php:8.2-cli）默认不包含composer命令，必须用官方脚本安装而非apt；同时需启用zip/mbstring等扩展，配置composer_home并调高memory_limit，推荐多阶段构建优化缓存。
容器里执行 composer install 报 command not found
根本原因是官方 PHP 镜像（如 php:8.2-cli）默认不带 composer 命令，不是环境变量或 PATH 没配好，而是压根没装。用 apt install composer 也不推荐——版本陈旧、权限混乱、与 PHP 扩展耦合差。
- 必须用官方安装脚本：
curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer - 安装后验证：
docker run --rm php:8.2-cli composer --version，若报错说明镜像层没生效 - 多阶段构建中，
composer只需存在于构建阶段镜像，最终运行镜像里不需要它
composer install 卡在 failed to open stream: php_network_getaddresses
这不是 DNS 配置错了，是容器启动时网络尚未就绪，尤其在 K8s Init Container 或函数计算冷启动场景下，CoreDNS、Service Endpoint 还没注册完成，nslookup packagist.org 直接失败。
- 别在 Pod 启动流程里依赖网络拉包——
composer install必须在构建阶段完成 - 若真要等网络（比如做健康检查），用
busybox+nc -z packagist.org 443，而不是让 Composer 自己重试 - 国内环境建议在 CI 构建时提前切镜像源：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，再clear-cache
报 Permission denied 写 vendor/ 或缓存目录
常见于挂载宿主机目录（-v $(pwd):/app）后在容器内执行 composer install，生成的 vendor/ 属主变成 root，而宿主机当前用户无权读写；或容器 UID 与宿主机不一致，导致文件系统拒绝写入。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 永远不要用
sudo composer install——它会把整个vendor/树设为 root 所有，后续所有操作都卡住 - 本地开发时，启动容器指定 UID：
docker run -u $(id -u):$(id -g) -v $(pwd):/app php:8.2-cli composer install - Dockerfile 中避免
COPY . .后再跑composer install，应先COPY composer.json composer.lock .，再RUN composer install，否则代码一改，vendor 层缓存全失效
构建成功但运行时报 Class not found
典型症状是镜像能跑起来，但第一次 HTTP 请求就崩，日志里找不到类。问题不在依赖没装，而在 autoloader 没生成或不完整——尤其是云函数或只读容器，autoload_static.php 必须在构建时固化，运行时无法动态生成。
- CI 构建命令必须带全参数：
composer install --no-dev --optimize-autoloader --classmap-authoritative --prefer-dist - 紧接执行：
&& composer dump-autoload --optimize --classmap-authoritative，否则autoload_static.php不生成 - 确认
WORKDIR和autoload.php路径一致，比如require __DIR__.'/vendor/autoload.php'要能从入口文件正确解析
真正麻烦的不是报什么错，而是把 composer install 放到运行时这个动作本身——它意味着你放弃了镜像不可变性、环境一致性、启动确定性。所有错误现象，几乎都是这个前提被违背后的自然反馈。
