composer.json autoload配置失效的主因是json非法、psr-4命名空间未用双反斜杠、路径非绝对格式、命令未在项目根目录执行；需验证物理路径存在性、大小写一致性及bom问题。
composer dump-autoload -v 输出里压根没出现你的命名空间
这说明 composer.json 的 autoload 配置根本没被读取或解析成功，不是路径错、不是大小写错，是配置本身“失效”了。
常见原因包括：
-
composer.json有非法 JSON：漏逗号、多逗号、用中文引号、末尾多逗号（尤其在 Windows 编辑器里容易混入 BOM） - PSR-4 命名空间键写成
"App"或"App/"，必须是"App\"（JSON 中两个反斜杠表示一个字面量反斜杠） - 路径用了相对写法，比如
"./src/"或"src"（缺末尾斜杠），Composer 只认"src/"这种绝对路径式写法 - 运行命令时不在项目根目录，
composer dump-autoload -v会静默失败且不报错，但扫描路径全错
vendor/composer/autoload_psr4.php 里有映射，但 class_exists() 返回 false
映射存在 ≠ 路径可达。关键看 $baseDir . '/src' 拼出来的真实路径是否存在、可读、大小写完全匹配。
执行这行命令直接验证物理路径是否成立：
php -r "require 'vendor/autoload.php'; var_dump(realpath('src/Services/UserService.php'));"
如果返回 bool(false)，说明文件根本不在那里——可能部署时漏拷贝、CI 构建路径写错（如把 src/ 写成 app/）、或 Linux 下文件名大小写不一致（userservice.php ≠ UserService.php）。
还要检查：autoload_psr4.php 里该命名空间对应的值是不是 $baseDir . '/src'，而不是硬编码的 /var/www/project/src（后者在容器或不同服务器上必然失效）。
类文件存在、路径对、命名空间声明也对，但 new 时仍报 Class not found
这时候问题往往出在 PHP 自身加载环节，而非 Composer 映射逻辑。
排查要点：
- 确认
vendor/autoload.php确实被引入，且用的是require __DIR__ . '/vendor/autoload.php';，不是require './vendor/autoload.php';（相对路径依赖当前工作目录，CLI 和 Web SAPI 下行为不一致） - 检查文件开头是否有 UTF-8 BOM（尤其 Windows 编辑器保存时默认加），会导致 parse error 静默中断 autoload 流程；用
head -n1 src/Services/UserService.php | hexdump -C查看是否以ef bb bf开头 - 确认类定义前没有语法错误、短标签（
）且short_open_tag未开启、或用了 PHP 8.2+ 新语法但运行环境版本更低 - OPCache 缓存了旧的 opcode，即使
autoload_psr4.php已更新，PHP 仍按旧路径找类；需执行php -r "opcache_reset();"或重启 PHP-FPM
生产环境 CI/CD 后自动加载突然失效
本地好、上线崩，90% 是部署流程绕过了 autoload 生效链路。
典型陷阱：
- CI 构建时用
composer install --no-dev --optimize-autoloader，但没加--classmap-authoritative，导致运行时 fallback 到 PSR-4 动态查找，而$baseDir在容器里算错了 - 构建完直接
rsync或cp -rvendor 目录到生产机，但属主仍是构建用户（如root或jenkins），而 Web 进程以www-data运行，读不到autoload_psr4.php - Docker 多阶段构建中，vendor 目录从 builder 阶段 COPY 到 final 阶段后，没重设权限：
RUN chown -R www-data:www-data /app/vendor必须显式加 - 用了
--classmap-authoritative，但部署脚本并发执行多个composer dump-autoload，导致autoload_classmap.php被截断（它必须完整且只读）
最易被忽略的一点：autoload_psr4.php 是 PHP 代码，里面 $baseDir 的计算依赖于 vendor/autoload.php 所在位置；如果入口脚本移动了 vendor 目录（比如 symlink 到别处），$baseDir 就会指向错误根路径，所有 PSR-4 映射都失效——这种问题不会报错，只会静默找不到类。
