composer require报错“could not find package”主因是包名错误或未配置对应仓库源；需核对官方文档包名、添加私有源或github vcs仓库、检查php版本及扩展依赖、确认自动加载路径与psr-4映射、更新autoload映射、注意sdk版本差异与服务包分离、切换国内镜像源、避免dev-master不稳定分支，并验证https调用。
composer require 报错“could not find package”
找不到包，八成是拼错了名字，或者没加正确的仓库源。Composer 默认只查 packagist.org，但很多国内 SDK（比如阿里云、腾讯云的 PHP SDK）得走他们自己的私有源，或者 GitHub 直链。
- 先确认包名是否准确——去官方文档复制
composer require xxx/xxx这一行，别手敲，aliyun-openapi-php-sdk和alibabacloud/openapi-sdk-php是两回事 - 如果包在 GitHub 上，但没上 Packagist，得手动加
repositories到composer.json，例如：{"type": "vcs", "url": "https://github.com/xxx/sdk"} - 有些 SDK 要求 PHP 版本或扩展（如
ext-curl、ext-json），报错里带requires ext-xxx就得先装系统扩展，不是 Composer 能解决的
require 后 vendor/autoload.php 不生效
自动加载没反应，常见于没正确引入 autoload，或者用了 PSR-4 但目录结构/命名空间对不上。
- 确保在入口文件（比如
index.php）顶部写了：require __DIR__ . '/vendor/autoload.php';
，路径不能错，__DIR__是当前文件所在目录，不是脚本执行目录 - 检查 SDK 的
composer.json里autoload段有没有定义psr-4映射，比如"AlibabaCloud\Client\": "src/"，那你的代码里就得用use AlibabaCloudClientAlibabaCloud; - 改过
composer.json或手动挪过 vendor 里的文件？运行一次composer dump-autoload，否则新类不会进自动加载映射表
SDK 初始化时报 Class not found 或 Method not found
类存在、也引入了，但一 new 就报错，大概率是版本不匹配，或者调用方式过时。
- 老 SDK（比如早期
aliyun-php-sdk-core）用new DefaultAcsClient(...)，新版本（alibabacloud/client）必须用AlibabaCloud::accessKeyClient(...)->asDefaultClient(); - 看 SDK 的
CHANGELOG.md或 GitHub Release 页面，v3 和 v4 的构造函数参数顺序、必填项可能完全不同；regionId在旧版是可选，在新版可能是强制字段 - 有些 SDK 分核心包 + 服务包（如
alibabacloud/ecs），只require核心包是不够的，还得单独require对应服务包，否则EcsClient类根本不存在
composer install 卡住或超时
尤其在国内，直接连 Packagist 或 GitHub 下载 zip 包经常失败，不是网络问题，是默认源太慢或被限速。
- 换国内镜像源最有效：
composer config -g repo.packagist composer https://packagist.phpcomposer.com（注意：该源已停，推荐用https://mirrors.aliyun.com/composer/） - 如果项目里已有
composer.lock，但本地 PHP 版本和 CI 不一致，composer install可能拒绝执行——删掉 lock 文件重composer update不是好办法，优先用composer install --ignore-platform-reqs绕过版本检查（仅开发环境） - 某些 SDK 的
dev-master分支依赖不稳定，composer require xxx/dev-master容易拉到半成品，明确指定稳定版本号，比如composer require alibabacloud/client ^3.0
真正麻烦的是跨平台兼容性：Windows 下路径分隔符、Mac 下 OpenSSL 版本、Docker 里没装 ext-openssl ——这些错误不会出现在 composer require 阶段，而是在第一次调用 SDK 发起 HTTPS 请求时才暴露。别只盯着安装成功，得跑通一个最简的 listBuckets 或 DescribeRegions 才算真正对接完成。
