PSR-4类未找到的主因是命名空间与文件路径不匹配，需严格遵循AppServiceUser→src/Service/User.php规则，检查composer.json、namespace声明、路径斜杠、大小写，并执行composer dump-autoload -o。
psr-4 命名空间与文件路径不匹配是最常见原因
报 Class not found 却确认类文件存在？90% 是 namespace 和目录结构对不上。PSR-4 不是“猜路径”，而是严格按规则映射：App\Service\User 必须对应 src/Service/User.php，少一层目录、多一个下划线、大小写错（尤其 Linux/macOS）都会失败。
检查要点：
-
composer.json中"psr-4": {"App\": "src/"}的命名空间末尾必须有双反斜杠\，不能写成"App"或"App" - PHP 文件里的
namespace声明必须完全一致，包括前缀、大小写、结尾分号前无空格 -
src/是相对于composer.json所在目录的真实路径，不能是./src/或绝对路径，且末尾斜杠不能省（"src"和"src/"在部分系统下行为不同） - 新增类后，必须运行
composer dump-autoload -o；只改文件不 dump，自动加载器永远看不到它
classmap 和 psr-4 混用导致类“两头不靠”
你在 autoload 里同时配了 psr-4 和 classmap，还把同一个类的文件既放在 PSR-4 路径下、又手动加进 classmap？Composer 会优先走 PSR-4 规则，但若该文件没声明对应 namespace，PSR-4 直接跳过；而 classmap 又因 PSR-4 已覆盖，不会生效——结果就是类彻底找不到。
实操建议：
- 同一类名不要同时出现在两种 autoload 规则中，否则行为未定义
-
psr-4适合有规范命名空间的新代码；classmap仅用于无 namespace 的老工具类或函数文件（如helpers.php），且必须显式列出完整路径 - 混用时，用
composer dump-autoload -o --no-dev验证生产环境映射，避免 dev-autoloading 干扰判断 - 怀疑冲突？删掉
vendor/composer/autoload_*.php，再重跑dump-autoload -o，比反复执行命令更彻底
第三方包自带 autoloader 与 Composer 冲突
有些包（尤其是非 Packagist 发布的老库）会在自身代码里调用 spl_autoload_register() 或手动 require，一旦你又用 composer require 引入它，就可能注册重复加载器，引发 Cannot declare class 或静默失效。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
排查方式：
- 搜索项目中所有
require、include、spl_autoload_register调用，特别是入口文件和配置文件附近 - 运行
composer show vendor/package，看输出中autoload字段是否为空或为{}；若为空，说明该包不支持 Composer 自动加载，需手动处理 - ThinkPHP 等框架项目中，避免把第三方类直接扔进
app/或extend/后不声明 autoload —— 这等于绕过 Composer，又没走框架加载机制 - 确认
vendor/autoload.php是**第一个被require的文件**，且路径正确：用__DIR__ . '/vendor/autoload.php'，别用相对字符串'vendor/autoload.php'
依赖树里隐藏的 autoload 锁定冲突
不是你写的 composer.json 错了，而是某个间接依赖（比如 require-dev 里的 phpunit）悄悄锁死了某个底层包的版本，导致它的 autoload 规则和你主项目的不兼容。这类问题在 composer install 成功但运行时报 Class not found 时特别隐蔽。
关键动作：
- 运行
composer why-not target/package:version，从输出最后一行往上读，找真正卡住的那条依赖链 - 用
composer show --tree | grep -A3 -B3 "target/package"查它被谁引入、锁定在哪个版本 - 检查
composer.lock里该包的autoload字段，确认其声明的命名空间是否和你的使用方式冲突（例如它声明"psr-4": {"Foo\": "src/"}，但你 new 的是FooBar，而文件却在lib/Bar.php） - 升级包时务必加
--with-dependencies，否则子依赖仍卡旧版，autoload 映射无法对齐
最易被忽略的一点：autoload 生效依赖于 vendor/autoload.php 被正确引入，而这个文件本身是否能被找到，又取决于你入口文件的当前工作目录和路径写法。哪怕所有配置都对，require 'vendor/autoload.php' 写在 public/index.php 里却没加 __DIR__，在 CLI 和 Web SAPI 下行为可能完全不同。
