答案是先定位报错路径归属，再用sudo chown -R $USER:$USER修复本地源目录所有权，并检查~/.composer及缓存目录归属是否正确。报错含file_get_contents(/path/to/my-repo/packages.json)说明本地源路径属主非当前用户，需递归修正所有权，禁用chmod -R 777，确保路径为绝对路径且支持Unix权限。
报错含“file_get_contents(/path/to/my-repo/packages.json): Permission denied”
这说明 Composer 正在尝试读取你配置的本地源（比如 repositories 里 type 为 path 或 package 的条目），但路径归属不是当前运行用户。Linux/macOS 下，哪怕权限是 755，只要属主是 root 或 www-data，file_get_contents() 就会直接拒绝——不是没读权限，是“不认你这个人”。
立刻执行：ls -ld /path/to/my-repols -ld /path/to/my-repo/packages.json
如果第三列（属主）不是 $(whoami)，问题就定位了。
- 用
sudo chown -R $USER:$USER /path/to/my-repo递归修复所有权，别碰chmod -R 777 - 确认
composer.json中的url是绝对路径，例如"url": "/home/alex/my-local-package"，避免"../relative"在不同上下文解析失败 - 路径含空格或中文？改用
file://前缀更稳："url": "file:///home/alex/my%20local%20package" - 若该目录挂载自 Windows 共享盘或 Docker volume，先
touch /path/to/my-repo/test && rm /path/to/my-repo/test验证是否支持 Unix 权限；不支持就挪到~/repos/再试
CI/CD 流水线里 vendor 目录报 Class not found
这不是包没装全，而是缓存了错误版本的 vendor/：不同 PHP 版本、xdebug 开关状态、甚至不同 OS 下生成的 autoloader 不能混用。CI 中缓存 vendor/ 是高危操作，应只缓存 ~/.composer/cache。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 检查 CI 脚本是否误用了
CACHE_PATH: vendor/，正确做法是缓存~/.composer/cache并设置COMPOSER_CACHE_DIR - 如果已缓存过
vendor/，必须在composer install前加rm -rf vendor/ - 后续命令必须带
--no-cache，并设环境变量：COMPOSER_CACHE_DIR=/dev/null composer install --no-cache --prefer-dist - PHP 版本切换后必现此问题，可在 install 前加检测：
php -v和composer show --platform | grep php对比是否匹配composer.json中的"php": "^8.1"
“Failed to extract” 或 “corrupted archive” 不是网络问题
根本原因是 ~/.composer/cache/files/ 下某个 ZIP 文件本身损坏了——下载中断、磁盘写入异常、镜像同步滞后导致校验哈希不匹配。在 CI 环境中，composer clear-cache 往往无效，因为缓存路径可能被挂载为持久卷，且命令执行用户与配置用户不一致。
- 先确认实际运行用户：
whoami，别用sudo composer config -g写进 root 的配置，runner 用户读不到 - 验证镜像是否真生效：
composer config -g repo.packagist必须输出完整 JSON，URL 末尾带斜杠（如https://mirrors.aliyun.com/composer/） - 绕过缓存干扰最可靠的方式是设环境变量：
COMPOSER_CACHE_DIR=/dev/null composer install --no-cache --prefer-dist - 若仍失败，说明缓存目录权限错位：运行
ls -ld $(composer config --global cache-dir)，若 owner 是root，执行sudo chown -R $USER:$USER $(composer config --global cache-dir)
composer config -g repo.packagist 输出为空或仍是 packagist.org
说明配置根本没写进去，不是“没生效”，是压根没存成功。Composer 2.x 会静默回退到官方源，不报错也不提醒。
-
repo.packagist必须是单数，写成repos.packagist或repositories.packagist.org都无效 - 命令末尾必须带
composer作为 type 值：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - URL 必须 HTTPS 且以
/结尾：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（拼出/composerpackages.json导致 404） - 必须加
-g，否则只改当前项目composer.json，换目录就失效 - CI/CD 或宝塔环境常见问题：你用
root配的全局镜像，但实际运行的是www用户，得用sudo -u www composer config -g单独配
