composer不允许classmap与psr-4同时映射同一类名，否则会静默跳过或抛出“cannot declare class xxx, because the name is already in use”；应优先删除classmap条目，确保psr-4路径真实存在，并用composer dump-autoload -v验证映射。
autoload 中 classmap 和 psr-4 同时声明同一命名空间会报错
Composer 不允许同一个类名被多个 autoload 规则覆盖，一旦 classmap 和 psr-4 都映射到 App\ 这类命名空间，运行 composer dump-autoload 时会静默跳过或在加载时抛出 Class not found，但更常见的是启动时提示 Cannot declare class XXX, because the name is already in use。
实操建议：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 用
composer dump-autoload -v查看详细映射路径，确认是否有重复注册 - 检查
composer.json的"autoload"和"autoload-dev"两块，特别注意是否在 dev 区域误加了生产环境已有的映射 - 优先删掉
classmap条目——除非你真有散落在非标准路径下的 PHP 文件需要兜底加载 - 确保所有
psr-4声明的目录真实存在且可读，空目录不会报错但会导致类找不到
vendor/autoload.php 被多次 require 或 include
有些框架（如 Laravel）会在入口文件自动加载 vendor/autoload.php，若你在中间件、服务提供者或配置文件里又手动 require 一次，就会触发 Cannot redeclare class。这不是 Composer 配置问题，而是执行流污染。
实操建议：
- 全局搜索项目中所有
require、include、require_once和include_once，重点排查autoload.php字样 - 用
get_included_files()在出错前打印已加载文件列表，确认是否重复 - 永远只在项目唯一入口（如
public/index.php）中require 'vendor/autoload.php'，其余地方不要碰它
第三方包的 autoload 与本地代码冲突
比如你安装了 monolog/monolog，它自身声明了 Monolog\ 的 psr-4 映射；而你本地也建了个 app/Monolog/ 目录并配了同名命名空间，Composer 加载时就会按注册顺序取第一个匹配项，后续类可能直接被跳过。
实操建议：
- 运行
composer show -t查看完整依赖树和 autoload 注册顺序 - 用
composer dump-autoload --no-dev测试是否仅因 dev 包引发冲突（比如某些测试工具自带 mock 类） - 本地命名空间尽量避开通用词（如
Log、Cache、Helper），改用带业务前缀的，例如Acme\Log\ - 若必须覆盖第三方类，用
classmap+exclude-from-classmap精确控制，而不是靠 PSR 映射“抢跑”
autoload 生成后未生效或缓存残留
composer dump-autoload 默认只更新 vendor/composer/autoload_*.php，但某些 SAPI（如 PHP-FPM）或 CLI 环境下 opcache 会缓存这些文件，导致改完配置仍走旧逻辑；另外，Laravel 的 bootstrap/cache/packages.php 或 config.php 也可能固化了旧类映射。
实操建议：
- 先清 opcache：
opcache_reset()或重启 PHP-FPM - 删掉
vendor/composer/autoload_*.php手动触发重建 - Laravel 项目额外执行
php artisan config:clear和php artisan cache:clear - 用
composer run-script post-autoload-dump检查是否有自定义脚本干扰生成过程
autoload-dev 里混进了生产环境类路径，以及在 tests/ 下写了和 app/ 同名命名空间的类——它们不会立刻报错，但一跑测试或切环境就崩。
