Laravel结合React搭建SPA时web通配路由误接管API路由的解决方法

当前遇到的API请求被通配路由拦截，本质是web通配路由没有做匹配边界限制，叠加路由加载顺序不当导致的请求错配，整套适配方案不需要在Laravel和React两端重复维护相同的路由规则。

核心配置调整 #

• 修改web.php的通配路由规则，用正则负向断言直接排除所有API前缀的请求，从规则层面杜绝通配路由越权匹配：
  原先无边界的通配写法会匹配所有路径，包括API请求：

Route::view('{any}', 'app')->where('any', '.*');

加了排除规则的写法，仅匹配非API的路径：

Route::view('{any}', 'app')->where('any', '^(?!api\/)[\/\w\.-]*');

这段正则的核心作用是：只要请求路径以api/开头，就不会触发当前通配路由的匹配，这类请求会被自动路由到api.php中定义的对应接口逻辑处理。

路由加载顺序校验 #

• 保证Laravel默认的路由加载优先级：带api前缀的api.php路由组，加载优先级高于web.php中的所有路由，通配路由必须放在web.php文件的最末尾，不要前置到其他业务web路由之前，避免把正常的非API业务请求也拦截了。
• 完全不需要逐一定义React端的页面路由：所有被通配规则放行、返回给前端SPA模板的路径，全部交给React Router做客户端路由匹配，Laravel端不需要重复维护前端路由列表，从机制上避免两端重复编写路由的问题。

配置注意事项 #

• 如果后续调整了API路由的统一前缀（比如从默认的api/改成admin-api/），需要同步修改通配路由正则中的排除规则，保证排除规则和实际的API前缀完全匹配。
• 配置调整完成后必须清理路由缓存：开发环境执行php artisan route:clear清除旧缓存，生产环境重新执行php artisan route:cache生成最新的路由缓存，避免旧规则残留导致匹配异常。
• 对于应用中其他独立的、不需要走SPA渲染的路径（比如第三方支付回调webhook、静态资源访问路径），如果不想被通配路由拦截，也可以同步加入正则的排除规则列表。

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