私有仓库中拉取public包（如easywechat/easywechat）需确保Composer同时查询私有源和Packagist官方源：禁用"packagist": false，改用显式声明"packagist.org": {"type": "composer", "url": "https://packagist.org"}，并避免repositories配置导致官方源被屏蔽或降权。
私有仓库里怎么拉取 public 包（比如 easywechat/easywechat）？
私有仓库（如 Satis、Private Packagist 或自建 Artifactory）默认只代理或托管你明确配置的包，packagist.org 上的公共包不会自动透传。直接 composer require easywechat/easywechat 会失败，报错类似 Could not find package easywechat/easywechat。
解决方式不是把公共包“上传”到私有仓，而是让 Composer 同时查私有源和 Packagist 官方源：
- 确保私有仓库配置中没禁用 Packagist：检查
composer.json的repositories，不要写"packagist": false；如果用了"packagist.org": false，要改成"packagist.org": {"type": "composer", "url": "https://packagist.org"} - 若私有仓库是 Satis，其
packages.json必须包含"include": ["https://packagist.org/packages.json"]才能合并上游元数据 - CI/CD 环境中常见漏掉
--no-interaction导致交互式提示中断安装，加这个参数可跳过信任确认
retailcrm/api-client-php 和 mangopay/php-sdk-v2 能共存吗？
能，但版本约束容易冲突——两者都依赖 psr/http-client、guzzlehttp/guzzle，但要求的版本范围可能不重叠。例如 retailcrm/api-client-php:^6.0 要求 guzzlehttp/guzzle:^7.5，而老版 mangopay/php-sdk-v2:^2.1 锁死在 ^6.5。
实际处理建议：
- 优先升级 SDK：查各包的
composer.json中require字段，确认最小兼容 Guzzle 版本；mangopay/php-sdk-v2已有^7.0兼容分支，改用"mangopay/php-sdk-v2":"dev-main"（需设"minimum-stability": "dev"） - 不强行降级 Guzzle：Guzzle 6 和 7 的 PSR-18 实现不兼容，混用会导致
ClientInterface类找不到 - 用
composer prohibits guzzlehttp/guzzle快速定位哪个包卡住了版本升级
私有包和公共 SDK 的 autoload 冲突怎么破？
典型现象：运行 composer dump-autoload 没报错，但调用 EasyWeChatFactory::miniProgram() 时抛 Class not found，而 vendor/autoload.php 明明已引入。
根本原因常是 autoload 优先级错乱：
- 私有包若设了
"type": "library"并配了"psr-4": {"My\Sdk\": "src/"}，但 src/ 下又意外放了vendor/子目录（比如前端构建产物），Composer 会尝试加载里面非法的 PHP 文件，导致 autoloader 初始化失败 - 公共 SDK 如
api2pdf/api2pdf.php自带autoload.files引入全局函数，若你的私有包也用了"files"且顺序靠后，函数可能被重复声明而 fatal error - 验证方法：执行
composer show -p查看所有包的 autoload 配置；用composer dump-autoload -v观察是否跳过了某些路径
私有仓库上线后，composer install 变慢甚至超时？
不是网络问题，大概率是 Composer 在每个包上都去私有源 + Packagist 双查，尤其当私有源响应慢或返回 404 太多时，会显著拖慢整体速度。
优化关键点：
- 把私有包显式声明进
composer.json的repositories，并加"only": ["myorg/*"]（Satis 支持，Private Packagist 用 scope 配置），避免无谓扫描 - 禁用 Packagist 的自动 fallback：设
"packagist.org": false，再手动加一条"packagist": {"type": "composer", "url": "https://packagist.org"}，确保顺序可控 - 生产环境务必加
--no-dev：很多公共 SDK 的require-dev里含大型测试工具（如phpunit/phpunit），它们的依赖图会触发额外元数据请求
最易被忽略的是镜像源配置残留——本地开发用阿里云镜像，CI 服务器却没同步该配置，结果私有包走内网，公共包全走海外源，延迟翻倍。每次部署前用 composer config --list 核对 repositories 输出。
