composer dump-autoload --optimize仅加载单个包类问题排查

核心原因 #

Composer的自动加载机制不会自动扫描vendor目录下的所有composer.json文件，只有当包被明确添加到项目根目录的composer.json依赖中，或者通过自定义仓库配置被Composer识别，它才会将该包的自动加载规则合并到项目的全局自动加载文件里。你遇到的问题大概率是以下几种情况：

• 项目根composer.json未声明kingsoft/http依赖：你手动将kingsoft/http放到了vendor目录，但没有在项目根的composer.json里添加这个包的require项，Composer执行dump-autoload时只会处理已声明的依赖（比如kingsoft/persist应该是被正确引入了），自然会忽略未被识别的kingsoft/http。
• 本地开发包未配置自定义仓库：如果这两个是你本地开发的私有包，没上传到Packagist这类仓库，Composer默认找不到它们，即使放在vendor里也不会当作合法依赖处理。
• 类文件未遵循PSR-4规范：虽然http包的composer.json配置了PSR-4映射，但要确保Request.php的命名空间是Kingsoft\Http，且类名和文件名严格一致（Request.php对应Request类），否则也会导致加载失败。不过既然Persist类能正常加载，这个可能性相对较低，但可以排查。

解决步骤 #

1. 在项目根composer.json添加依赖
   打开项目根目录的composer.json，在require字段中加入kingsoft/http：

   {
       "require": {
           "kingsoft/persist": "*",
           "kingsoft/http": "*"
       }
   }
   

   如果是本地开发包，先完成下一步仓库配置，再执行composer update。

2. 配置本地路径仓库（针对本地包）
   若这两个包是本地开发的，在项目根composer.json中添加仓库配置，让Composer能识别本地包：

   {
       "repositories": [
           {
               "type": "path",
               "url": "./vendor/kingsoft/http"
           },
           {
               "type": "path",
               "url": "./vendor/kingsoft/persist"
           }
       ],
       "require": {
           "kingsoft/persist": "*",
           "kingsoft/http": "*"
       }
   }
   

   执行composer update后，Composer会处理依赖并更新自动加载规则。

3. 验证PSR-4规范匹配
   检查vendor/kingsoft/http/src/Request.php的内容，确保命名空间和类名正确：

   <?php
   namespace Kingsoft\Http;
   
   class Request {
       // 类逻辑
   }
   

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