本地path仓库autoload不生效的根本原因是主项目未在顶层autoload字段中显式配置其PSR-4映射，且未执行composer dump-autoload；必须确保路径正确、命名空间末尾双反斜杠、映射位于composer.json顶层，并验证autoload_psr4.php生成结果。
本地path仓库的autoload配置不生效
本地 path 仓库（如 "my/package": "packages/my-package"）默认不继承主项目的 autoload 规则，也不会自动触发 dump-autoload——它的类不会被主项目自动加载，除非显式声明。你改了 packages/my-package/src/MyClass.php 并运行 composer install，但 class_exists('MyPackageMyClass') 仍返回 false，问题就出在这里。
-
path类型仓库是“符号链接式”安装，Composer 只把它当普通依赖挂载到vendor/my/package，不会扫描其内部composer.json的autoload字段 - 主项目
composer.json中必须手动为该包添加 PSR-4 映射，例如："My\Package\": "packages/my-package/src/" - 改完后必须立即执行
composer dump-autoload，否则映射不会写入vendor/composer/autoload_psr4.php - 若
packages/my-package/composer.json本身有"autoload": {"psr-4": {"My\Package\": "src/"}}，它只对“以该包为根”的独立使用场景有效，对主项目无影响
为什么 composer dump-autoload -v 扫不到 path 包里的类
运行 composer dump-autoload -v 时，输出里没有 Scanning packages/my-package/src/ for namespace My\Package\，说明 Composer 根本没读取你为它加的映射。常见原因：
- 主项目
composer.json的autoload键写在了require或repositories下面——它必须是顶层字段，和name、require并列 - 命名空间末尾漏了双反斜杠：
"MyPackage"❌，"My\Package\"✅（JSON 中需两个反斜杠表示一个字面量反斜杠） - 路径用了相对写法如
"../packages/my-package/src/"——Composer 不支持上层路径，只接受以项目根目录为基准的相对路径，如"packages/my-package/src/" - 路径末尾没加
/，导致拼接出packages/my-package/srcMyClass.php这种错误路径
path 仓库类文件存在但 class_exists 返回 false
确认 packages/my-package/src/MyClass.php 存在、命名空间声明为 namespace MyPackage;、类名为 MyClass，但仍加载失败？重点查这三处：
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 运行
php -r "require 'vendor/autoload.php'; var_dump(class_exists('My\Package\MyClass'));"—— 直接验证是否真被加载，绕过框架或路由干扰 - 打开
vendor/composer/autoload_psr4.php，搜索'My\Package\'，确认其值是类似$baseDir . '/packages/my-package/src'的绝对路径表达式，并且$baseDir指向的是你的项目根目录（不是vendor/composer/../..那种错位路径） - 检查文件权限：Linux 下若
packages/my-package/src/所有者不是 web 服务用户（如www-data），file_exists()可能静默失败，用ls -l packages/my-package/src/MyClass.php确认可读
CI/CD 中 path 仓库部署后 autoload 失效
本地正常、CI 构建镜像后报 Class not found，大概率是构建流程跳过了 autoload 更新：
- 构建脚本用了
composer install --no-dev --optimize-autoloader，但没加--classmap-authoritative，导致 fallback 到 PSR-4 动态查找，而$baseDir在容器中计算错误 - 构建时把
packages/目录拷贝进了镜像，但composer.json中写的路径仍是"packages/my-package/src/"，而实际运行时项目根目录是/app，路径拼接后变成/app/packages/my-package/src/—— 必须确保容器内路径结构与开发环境一致 - 推荐在 CI 脚本末尾强制加一行：
composer dump-autoload -o --classmap-authoritative，它会生成完整 classmap 并禁用 PSR-4 fallback，避免路径推导环节出错 - 别在
autoload-dev里配 path 包的映射——生产环境composer install --no-dev会直接忽略它
最易被忽略的一点：path 仓库的类路径和命名空间必须和主项目 autoload 配置完全一致，差一个大小写、多一层目录、少一个反斜杠，autoload_psr4.php 就不会生成对应条目——它不报错，只是静默跳过。验证永远从 dump-autoload -v 输出和 autoload_psr4.php 文件内容开始，而不是猜代码哪错了。
