先运行composer validate --verbose定位错误字段、行号及类型预期，如expected object but got string；常见错误包括psr-4写成数组、scripts值为true/null、config.platform.php用数字而非字符串。
composer validate 报 JSON schema 不匹配，先看哪一行
直接运行 composer validate --verbose，它会明确告诉你出错字段、行号和类型预期，比如 expected object but got string。常见错误包括：autoload.psr-4 写成数组而非对象、scripts 里值设为 true 或 null、config.platform.php 写成数字 8.2 而非字符串 "8.2.0"。别靠肉眼扫——中文引号、BOM 头、多一个逗号，validate 都能揪出来。
dump-autoload -v 输出里没看到你的命名空间
说明 autoload 配置根本没被识别。检查三处硬性要求：autoload 必须是 composer.json 顶层键（不能嵌在 require 或拼错成 autoloader）；命名空间前缀必须带双反斜杠结尾（"App"✅，"App"❌）；路径值必须是相对路径且以正斜杠结尾（"src/"✅，"./src"❌，"src"❌）。运行 composer dump-autoload -v 后，如果输出里连 PSR-4 mapping: ["App" => "src/"] 都没有，就不是路径或类名问题，而是配置结构本身被忽略了。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
autoload_psr4.php 里有映射，但 class_exists() 仍返回 false
打开 vendor/composer/autoload_psr4.php，搜索你的命名空间前缀（如 "App\"），确认其映射的物理路径是否真实存在、大小写是否完全一致。重点排查：$baseDir 计算是否正确（部署时代码目录与 composer.json 相对位置是否偏移）；类文件名是否首字母大写（UserService.php✅，userservice.php❌）；命名空间声明末尾是否有反斜杠（namespace AppServices;✅，namespace AppServices❌ —— 少一个 会导致 PSR-4 截取逻辑偏移一级）；Linux 下文件权限是否可读（ls -l src/Services/UserService.php）。
PSR-4 和 classmap 混用后类加载行为异常
同一类名不能同时出现在两种规则中，否则行为未定义。典型冲突场景：psr-4 配了 "MyLib\": "lib/"，classmap 又加了 "lib/Utils.php"，而 Utils.php 没声明 namespace MyLib;。此时 PSR-4 规则优先触发但匹配失败，classmap 又因类名不匹配被跳过。解决原则：有命名空间的新模块走 psr-4；无命名空间的老代码（如 helpers.php）放 files；纯函数或遗留类放 classmap；二者共存时，确保类名不重叠，且 classmap 路径不包含已由 psr-4 覆盖的子目录。
dump-autoload -o 生成的 autoload_classmap.php 会掩盖 PSR-4 路径错误，而生产环境又常依赖这个优化模式——所以验证阶段必须关掉 -o，让路径拼接逻辑暴露出来。
