使用Composer Path仓库进行微服务公共库本地调试-composer-PHP中文网

path仓库本地调试不生效，根本原因是默认不启用符号链接且composer install不刷新已有链接；必须显式配置"options":{"symlink":true}、以管理员权限运行、执行composer update vendor/name重建链接，并确保路径、name、版本三者完全匹配。

使用composer path仓库进行微服务公共库本地调试

为什么 `path` 仓库在本地调试时经常不生效

Composer 的 path 类型仓库本质是软链接（symlink）或硬拷贝，但默认只在 composer install 或首次 composer require 时建立。后续你改了本地库代码，composer update vendor/name 不会自动同步——它只看 composer.lock 和远程包版本，完全忽略本地文件变动。

必须显式执行 composer update --with-dependencies 才可能触发重链接（取决于 Composer 版本）
更可靠的做法是删掉 vendor/name 目录后运行 composer install，强制重建 symlink
Windows 用户要注意：默认禁用 symlink，需以管理员身份运行 CMD/PowerShell，或启用 composer config -g system-config --enable-symlinks true

如何正确配置 `repositories` 的 `path` 类型

关键不是写对路径，而是路径必须指向含有效 composer.json 的目录，且该 JSON 中的 name 必须与你 require 的包名**完全一致**（包括大小写和 vendor 名）。

项目根目录 composer.json 中添加：

{
  "repositories": [
    {
      "type": "path",
      "url": "../my-shared-lib"
    }
  ],
  "require": {
    "acme/my-shared-lib": "*"
  }
}

../my-shared-lib 必须是相对当前项目 composer.json 的路径，不能是绝对路径（如 /Users/xxx/lib）
acme/my-shared-lib 必须与 ../my-shared-lib/composer.json 里声明的 "name": "acme/my-shared-lib" 完全匹配
如果本地库未发布过任何版本，"*" 是唯一可用约束；若已发过 v1.0.0，可写 "dev-main as 1.0.0" 强制走本地分支

`composer dump-autoload` 为什么解决不了类找不到问题

autoload 本身没问题，问题常出在自动加载路径没被正确注册——因为 path 仓库的 symlink 没建好，或者 composer.json 里的 autoload 配置有误。

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

检查 vendor/acme/my-shared-lib 是否为真实目录（不是空文件夹），且内容是否与 ../my-shared-lib 一致
确认本地库的 composer.json 中 autoload 正确，例如：

"autoload": {
  "psr-4": {
    "Acme\Shared\": "src/"
  }
}

运行 composer show acme/my-shared-lib 查看实际加载路径；若显示 source: dist 而非 source: path，说明没走 path 仓库
不要依赖 IDE 自动索引，手动在代码里 var_dump(class_exists('Acme\Shared\SomeClass')) 验证

微服务间多 `path` 依赖时的常见冲突

当 A 服务 require B 库，B 库又 require C 库，而你同时把 B 和 C 都设为 path 仓库时，Composer 可能因解析顺序混乱导致 symlink 错乱或版本锁死。

优先使用 path + dev-* 别名（如 "dev-main as 2.0.0"），避免 "*" 导致版本推导冲突
所有本地库的 composer.json 中，minimum-stability 统一设为 "dev"，并加 "prefer-stable": false
若出现 Root composer.json requires acme/c-lib * -> found acme/c-lib[dev-main] but it does not match your minimum-stability，就是稳定性配置不一致
最稳妥做法：每次只激活一个 path 仓库，其他仍走 packagist，等单点验证通过再逐步放开