命名空间冲突源于第三方库与thinkphp 5.1的psr-4自动加载规则不匹配，需检查三方面：composer.json是否配置psr-4映射、类文件路径是否与namespace严格一致（含大小写）、是否残留手动require干扰composer加载。
直接结论：命名空间冲突不是第三方库“有问题”，而是它和 ThinkPHP 5.1 的自动加载规则没对齐——核心要检查三件事：composer.json 是否声明了 PSR-4 映射、类文件路径是否与 namespace 完全一致、有没有手动 require 干扰 Composer 加载。
composer.json 里没配 autoload，类就永远找不到
TP5.1 彻底弃用 Loader::import() 和 vendor() 函数，所有第三方类必须走 Composer 自动加载。如果你是直接把第三方包扔进 extend/ 或 vendor/ 手动建的目录，但 composer.json 里没声明映射，框架根本不会扫描它。
- 确认第三方库的根命名空间（比如
phpoffice/phpexcel对应PHPExcel） - 在
composer.json的"autoload"下添加 PSR-4 映射："autoload": { "psr-4": { "PHPExcel\": "vendor/phpoffice/phpexcel/Classes/" } } - 运行
composer dump-autoload -o生效，别跳过-o（优化模式） - 如果包本身已带
autoload配置（看它自己的composer.json），你不用重复写，但要确保你composer require的是完整包，不是只下 ZIP 解压
namespace 和文件路径差一个字母，就会 Class not found
TP5.1 严格按 PSR-4 匹配：namespace applibrarypayment; 必须对应 app/library/payment/Paypal.php，不能是 app/library/Payment/Paypal.php（Payment 大写）或 app/library/payment/paypal.php（小写文件名）。
- 打开第三方类文件，第一行
namespace声明必须和你use时写的完全一致（包括大小写） - Linux 服务器上，
AppLibrary和applibrary是两个不同命名空间，路径也必须匹配 - 不要依赖 IDE 自动补全的
use——它可能从旧缓存里拉出错误路径，手动删掉重写一遍 - 实例化时加反斜杠？只对 PHP 内置类有效（如
DateTime），第三方类一律靠use或完整命名空间，别写PHPExcelIOFactory（除非你确定它没声明 namespace）
手动 include/require 和 Composer 混用，等于给 autoloader 下绊子
常见于老项目迁移：代码里还留着 require_once 'vendor/phpexcel/Classes/PHPExcel.php';，同时又用 composer require phpoffice/phpexcel。结果同一个类被加载两次，报 Cannot redeclare class。
- 全局搜索项目里所有
include、require、include_once、require_once，把指向第三方库的语句全干掉 - 检查
config/app.php里的'auto_load'配置，TP5.1 默认关闭，别手抖开成true - 如果第三方包不支持 Composer（极少数），把它放进
extend/目录，然后在composer.json里用 PSR-4 显式映射到extend/路径，而不是靠 TP 的 extend 自动注册（TP5.1 的 extend 注册机制不可靠）
最易忽略的点：TP5.1 不会帮你“猜”命名空间。它不看文件名、不读注释、不 fallback 到其他路径——错一个字符，就是 500。调试时先 var_dump(class_exists('PHPExcelIOFactory'))，再顺着 false 往前查 autoload 映射、文件路径、大小写，比翻文档快得多。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
