composer autoload 找不到 controller 类，是因为 composer.json 的 "autoload" 未正确配置 controller 目录路径与命名空间映射；即使文件存在、命名规范，也必须显式声明 psr-4（如 "appcontroller": "src/controller/"）并执行 composer dump-autoload 生效。
Composer autoload 为什么找不到 Controller 类
默认情况下，composer.json 的 "autoload" 配置不包含 Controller 目录，Composer 就不会为其中的类生成自动加载映射。哪怕文件命名规范、命名空间正确，class_not_found 错误仍会直接抛出。
关键不是“能不能”，而是“有没有告诉 Composer 这些类在哪、按什么规则找”。常见错误现象包括：Class AppControllerHomeController not found，即使该文件真实存在且 namespace AppController; 正确。
- 确认控制器目录在项目中实际路径（如
src/Controller/或app/Controllers/），路径必须与autoload中声明的一致 - 命名空间前缀（如
"App\"）必须与 PHP 文件顶部的namespace声明完全匹配，末尾双反斜杠不可省略 - 改完
composer.json后，必须运行composer dump-autoload（或composer install/update），否则变更不生效
psr-4 方式加载 Controller 最稳妥
psr-4 是目前最推荐的方式，它把命名空间前缀和物理路径绑定，支持子目录嵌套，也兼容现代框架（如 Symfony、Laravel 的控制器组织习惯）。
假设控制器放在 src/Controller/ 下，且所有类都以 AppController 开头：
{
"autoload": {
"psr-4": {
"App\Controller\": "src/Controller/"
}
}
}
这样写之后：AppControllerHomeController 会自动映射到 src/Controller/HomeController.php；AppControllerApiUserController 映射到 src/Controller/Api/UserController.php。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 路径值（
"src/Controller/"）是相对于composer.json所在目录的，不能写成绝对路径或带../ - 如果控制器分散在多个目录（比如
app/Http/Controllers和admin/Controllers），可以添加多条psr-4映射，但需确保命名空间不冲突 - 不要混用
psr-4和classmap加载同一组类，否则可能因加载顺序导致覆盖或重复声明
classmap 方式适合非标准结构
当控制器没有统一命名空间，或文件名不符合 PSR-4 规范（比如用下划线 Home_Controller.php、或类名与文件名不一致），classmap 是兜底选择——它靠扫描文件+解析 class 关键字来建映射，不依赖命名约定。
例如控制器散落在 controllers/ 目录下：
{
"autoload": {
"classmap": ["controllers/"]
}
}
运行 composer dump-autoload 后，Composer 会遍历该目录下所有 .php 文件，提取其中定义的类名并注册。
-
classmap不检查命名空间，也不要求文件路径与命名空间对应，适合迁移老项目 - 性能略低：每次
dump-autoload都要全量扫描，且无法支持动态新增类（除非重新 dump） - 注意排除测试文件或接口定义文件（如
*Test.php），避免污染自动加载器，可用"exclude-from-classmap"配置项
autoload-dev 和生产环境的陷阱
如果只在 autoload-dev 里配置了 Controller 路径，那 composer install --no-dev（生产部署常用）后，这些类就彻底不可用了——这是线上 500 错误的高频原因。
- Controller 是运行时必需类，必须放在根级
"autoload"下，而非"autoload-dev" -
"autoload-dev"只应放PHPUnit测试类、Faker数据工厂、或仅用于本地开发的命令行工具类 - 用
composer show --platform或临时加一句var_dump(class_exists('App\Controller\HomeController'));快速验证类是否被加载
最易被忽略的是：改了 composer.json 却忘了在 CI/CD 部署脚本里执行 composer dump-autoload，或者用了缓存镜像导致旧的 autoloader.php 一直生效。
