Composer本地仓库依赖问题：二级依赖导致composer update报错

问题分析与解决方案 #

我之前也碰到过几乎一模一样的本地嵌套依赖问题，这种情况大概率是Composer没正确识别到你的本地依赖链导致的，咱们一步步来排查解决：

1. 检查本地依赖的仓库配置是否完整 #

当你的depA依赖另一个本地包depB时，仅仅在depA的composer.json里声明依赖是不够的——Composer默认会去Packagist查找包，找不到本地的depB就会报错。你需要在**主项目main的composer.json**里统一配置所有本地包的仓库路径，让Composer知道去哪里找这些包。

举个正确的配置示例：
主项目vendor/main/composer.json：

{
    "name": "vendor/main",
    "require": {
        "vendor/depA": "*"
    },
    "repositories": [
        {
            "type": "path",
            "url": "../depA"
        },
        {
            "type": "path",
            "url": "../depB"
        }
    ]
}

vendor/depA/composer.json：

{
    "name": "vendor/depA",
    "require": {
        "vendor/depB": "*"
    },
    "version": "1.0.0"
}

vendor/depB/composer.json：

{
    "name": "vendor/depB",
    "version": "1.0.0"
}

2. 确认相对路径的正确性 #

一定要注意各个包之间的目录层级，比如如果你的三个包都在vendor目录下（vendor/main、vendor/depA、vendor/depB），那么主项目里配置的url应该是../depA和../depB，如果目录结构不一样，要调整对应的相对路径，否则Composer找不到包会直接报错。

3. 清除Composer缓存 #

有时候Composer会缓存旧的依赖解析结果，即使你修改了配置也不会立即生效。可以先执行以下命令清除缓存：

composer clear-cache

然后再重新运行：

composer update

4. 给本地包添加版本号 #

如果你的本地包depA或depB的composer.json里没有指定version字段，Composer可能无法正确解析依赖关系。给每个本地包加上明确的版本号（比如"version": "1.0.0"），能避免很多版本匹配的问题。

按照上面的步骤调整后，再执行composer update应该就能正常安装所有本地依赖了。

内容的提问来源于stack exchange，提问作者Kurztipp