Composer加载正常但报Swagger\Client\Configuration类未找到如何解决

核心错误原因 #

报错本质是Composer的PSR-4自动加载规则、文件目录、运行权限三者不匹配，和服务器预装的Composer环境无关，按以下步骤逐一排查即可修复。 #

修复步骤 #

• 核对命名空间与目录映射关系
  你当前composer.json中配置的"Swagger\\Client\\" : "lib/"规则，要求Swagger\Client命名空间下的所有类必须严格对应public_html/lib/下的目录结构：
  • Swagger\Client\Configuration类必须对应文件public_html/lib/Configuration.php
  • Swagger\Client\Api\MessagesApi类必须对应文件public_html/lib/Api/MessagesApi.php
    绝大多数同类报错都是因为Swagger生成的客户端代码存放层级错误，比如把带src/外层目录的代码包直接解压到lib下，导致实际文件路径变成public_html/lib/src/Configuration.php，自动加载逻辑无法命中。
• 补全composer.json依赖配置
  你当前的配置只声明了自动加载规则，没有引入Swagger客户端依赖的HTTP库，就算类加载问题修复，后续也会触发Guzzle相关的类找不到错误。将public_html/composer.json替换为以下内容：

  {
      "require": {
          "guzzlehttp/guzzle": "^7.0",
          "guzzlehttp/psr7": "^2.0"
      },
      "autoload": {
          "psr-4": { "Swagger\\Client\\" : "lib/" }
      }
  }
  

  如果是旧版本Swagger生成的客户端，将guzzle版本号改为^6.3即可兼容。
• 重新生成自动加载文件
  先删除public_html下已有的vendor目录和composer.lock文件，在SSH终端进入public_html目录后依次执行命令：

  composer install
  composer dump-autoload -o
  

  第二条命令会生成优化后的类映射表，可规避cPanel环境下PHP opcache缓存导致的自动加载规则不生效问题。
• 校验web进程文件权限
  WHM/cPanel环境下CLI执行用户和web运行PHP的用户不一致是常见坑：SSH下执行Composer的用户通常是cPanel账户或root，而web访问时PHP由php-fpm专属用户或nobody用户运行，需要确保lib、vendor两个目录的权限为755，目录内所有文件权限为644，属主对应当前cPanel账户，不要出现root属主或777权限，否则web进程无法读取类文件。
• 核对autoload文件引入路径
  你的业务代码sms.php位于public_html/converter/目录下，代码中写的require __DIR__ . '/../vendor/autoload.php'指向的是public_html/vendor/autoload.php，需要确认你执行Composer命令的工作目录是public_html，而不是converter目录或者账户根目录，避免vendor文件夹位置偏移。

额外注意事项 #

如果你的Swagger客户端是通过代码生成工具直接生成的完整包，不要手动编写autoload映射规则：直接进入客户端包的根目录执行composer install完成依赖安装，再将业务代码中的require路径指向客户端包内的vendor/autoload.php即可，手动映射容易出现命名空间斜杠漏写、路径层级错误的问题。

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