composer报“class not found”主因是autoload配置与实际文件结构不匹配：psr-4命名空间前缀（如"app"）须与php文件namespace声明逐字符一致（含末尾反斜杠），路径值（如"src/"）须为相对于composer.json的真实存在目录且结尾必须有斜杠。
autoload冲突本质是命名空间或路径不匹配
Composer报“Class not found”或“Cannot redeclare class”，90%不是依赖版本问题，而是autoload配置和实际文件结构对不上。PSR-4规则要求：命名空间前缀（如"App\"）必须与PHP文件里的namespace App\声明**逐字符一致**，包括末尾反斜杠；路径值（如"src/"）必须是相对于composer.json的**真实存在目录**，且不能漏掉末尾斜杠。
常见错误现象：
- 文件在
app/library/Payment.php，但composer.json里写"applibrary\": "app/library/"（少反斜杠），而PHP里却声明namespace applibrary; - 路径写成
"app/library"（无斜杠），在某些系统下会被当作文件而非目录处理，导致自动加载器跳过整个目录 - 用了
classmap又配了同名空间的psr-4，Composer优先走PSR-4，但文件没声明对应namespace，结果两头不加载
ThinkPHP项目要特别注意autoload注册顺序
TP5.1+和TP6都依赖Composer，但加载机制不同：TP6完全基于标准Composer结构，而TP5.1仍保留部分手动加载逻辑。若你在app/library/下放了Payment.php，命名空间必须是applibrary（注意反斜杠），且composer.json中需显式声明：
"autoload": {
"psr-4": {
"app\library\": "app/library/"
}
}
执行composer dump-autoload -o后，还要确认没有手动require或include相同类——ThinkPHP的APPPATH.'libraries/'和Composer的app/library/混用会直接触发Fatal error: Cannot declare class。
实操建议：
- 删掉
vendor/composer/autoload_*.php再跑dump-autoload -o，比反复执行更彻底 - 开发环境加
--no-dev参数验证生产加载路径：composer dump-autoload -o --no-dev - 检查第三方包是否自带
autoload逻辑（比如某些SDK会自己require_once），优先用composer require安装而非手动拷贝
composer dump-autoload -o 不生效？先查缓存和入口路径
vendor/autoload.php被require错位置是最隐蔽的原因之一。例如入口在public/index.php，却写成require '../vendor/autoload.php'（路径多了一层），或部署时CI构建产物没包含autoload_*.php文件。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
性能影响明显：不加-o时Composer fallback到文件扫描模式，不仅慢，还会掩盖路径错误——它可能“碰巧”找到类，但换个环境就失效。
排查步骤：
- 用
php -r "var_dump(class_exists('App\library\Payment'));"直连验证类是否存在 - 确认
vendor/autoload.php是否被正确require：在入口文件顶部加echo 'autoload loaded'; die;，看是否执行到 - 如果用Docker或CI，检查构建阶段是否执行了
composer dump-autoload -o，且vendor/目录被完整复制
多个autoload规则共存时的优先级陷阱
PSR-4和classmap可以共存，但同一类名不能出现在两种规则里。例如你同时配置：
"psr-4": { "MyLib\": "lib/" },
"classmap": [ "lib/Utils.php" ]
而Utils.php里没写namespace MyLib;，Composer就会忽略它——因为PSR-4规则已覆盖该路径，但文件不满足命名空间条件，classmap又被压制。
关键判断点：
- PSR-4是命名空间驱动，只认
namespace+ 目录结构，不关心文件名 - classmap是路径驱动，适合无命名空间的老代码，但必须确保文件里有
class Utils声明 - 两者混用时，用
composer show --tree查目标类是否出现在输出中；没出现，说明自动加载根本没注册它
真正容易被忽略的是：autoload配置改了，但vendor/composer/autoload_psr4.php等文件没更新，或者被OPcache缓存住了——这时候opcache_reset()比重跑dump-autoload更直接。
