应在 RouteServiceProvider 的 boot() 中用 Route::macro() 注册自定义路由方法，确保早于路由文件加载；避免在 apiRoutes() 中使用宏，改用显式 require；宏内只封装 method/URI/action，中间件应由用户显式添加。
怎么在 Laravel 路由里加自定义方法（比如 patchJson）
不能直接往 Route 类里硬塞新方法，Laravel 的路由注册机制是静态构建的，扩展必须走官方预留的钩子：通过 Route::macro() 注册宏命令。否则调用时会报 BadMethodCallException: Method patchJson does not exist。
实操建议：
- 在
app/Providers/RouteServiceProvider.php的boot()方法里注册，确保所有路由加载前宏已就位 - 宏函数体里必须调用
Route::match()或已有方法（如Route::post()），不能自己拼 URL 或伪造请求 - 别在闭包里用
$this—— 宏闭包里没有路由实例上下文，要用参数接收：function ($uri, $action) { return Route::post($uri, $action); }
Laravel 10+ 里 macro 不生效？检查是否用了 Route::apiRoutes()
如果你把自定义方法（比如 Route::jsonPost()）写在 routes/api.php，但只通过 Route::apiRoutes() 加载，那宏不会触发——这个辅助函数内部绕过了标准路由加载流程，不执行宏绑定逻辑。
实操建议：
- 改用
require __DIR__.'/api.php';显式引入（Laravel 默认就是这么做的，别为了“整洁”换成apiRoutes()） - 确认
Route::macro()调用早于任何require路由文件的行为，否则宏还没注册，路由已解析完毕 - 测试时用
php artisan route:list看输出里有没有你的自定义方法名，没有就说明注册时机错了
自定义路由方法要不要自动加中间件（比如 json 或 throttle）
可以加，但别默认硬编码。比如你写了个 Route::jsonPost()，如果内部自动加了 middleware('json')，遇到不需要校验 JSON body 的场景反而要绕弯子去掉，得用 withoutMiddleware() 补救，破坏简洁性。
实操建议：
- 宏函数本身只做 HTTP 方法 + URI + action 的封装，中间件交给使用者显式声明
- 真有高频共性需求（如所有
json*方法都要json中间件），提供一个独立的中间件组，在文档里说明，而不是塞进宏里 - 注意中间件顺序：如果宏里加了中间件，它会出现在用户后续链式调用的
->middleware()之前，可能影响执行顺序
Route::macro() 和服务容器绑定哪个更适合复杂逻辑
宏适合轻量封装（比如统一加前缀、固定 method + middleware 组合）。一旦涉及动态参数解析、条件分支（如根据环境决定是否启用缓存）、或需要依赖注入（比如要访问 Request 或配置），宏就撑不住了——它只是个静态函数，拿不到容器实例。
实操建议：
- 超过 3 行逻辑、含
if或依赖外部服务时，改用服务容器绑定 + 自定义路由闭包工厂 - 例如：绑定一个
JsonRouteBuilder类到容器，再在路由文件里app(JsonRouteBuilder::class)->post('/x', ...) - 宏无法做类型提示、IDE 跳转弱、调试时堆栈不清晰，复杂场景下这些隐性成本比多写两行代码高得多
