Laravel Modules API路由无法命中控制器问题排查与解决

问题场景 #

• 技术栈：laravel-modules 11.1.8 + Laravel 11.41.3 + Vue3 SPA
• 模块内Vue组件调用模块API路由时，返回结果是应用HTML模板而非预期的接口数据
• 执行php artisan route:list仅能看到主项目api.php中的路由，模块路由完全未显示
• 将模块api.php的路由代码复制到主项目api.php后，接口可正常响应

根因与解决步骤 #

问题出在模块配置的Service Provider生成开关：

1. 打开项目根目录的/config/modules.php配置文件
2. 定位到'provider'配置段中的'generate'参数，发现它被设置为false
3. 该参数的作用是控制是否自动生成模块对应的Service Provider（例如BlogServiceProvider），当值为false时，模块的路由不会被注册到Laravel应用中
4. 将'generate'的值修改为true，重新生成模块Provider后，模块路由成功注册，接口恢复正常工作

内容的提问来源于stack exchange，提问作者calin24