Laravel 10 API POST请求异常匹配Web路由问题求助

你遇到的核心问题是：/dp和/dj的POST请求未匹配到API路由，反而触发了Web路由的根视图（删除Web根路由后返回404），但其他HTTP方法（PUT/GET/DELETE）及其他API端点的POST请求均正常。

以下是可能的原因及对应解决方案：

1. 中间件冲突导致认证失败重定向 #

你的API路由组外层已添加auth:sanctum中间件，但内层apiResource又叠加了默认的auth中间件——默认auth中间件使用session guard，而API请求依赖sanctum token认证，这会导致auth中间件判定用户未登录，从而重定向到Web根路由（即welcome.blade.php）。

解决方案 #

移除内层重复的auth中间件（外层已通过auth:sanctum完成认证，无需重复添加）：

// api.php 修改后
Route::group(['namespace' => 'App\Http\Controllers', 'middleware' => 'auth:sanctum'],function () {
    Route::apiResource('users', UserController::class)->middleware(['verified','role:admin']);
    Route::apiResource('mous', MouController::class)->middleware(['verified','role:admin|nasabah|banker']);
    Route::apiResource('office', OfficeController::class)->middleware(['verified','role:admin']);
    Route::apiResource('jdp', JDPController::class)->middleware(['verified','role:admin|nasabah|banker']);
    Route::apiResource('dp', DPController::class)->middleware(['verified','role:admin|nasabah']);
    Route::apiResource('jdj', JDJController::class)->middleware(['verified','role:admin|nasabah']);
    Route::apiResource('dj', DJController::class)->middleware(['verified','role:admin|nasabah']);
});

2. 请求头缺失导致Laravel识别为Web请求 #

API请求必须携带Accept: application/json请求头，否则Laravel会将其当作Web请求处理——若认证失败，会重定向到Web根路由。

解决方案 #

确保POST请求的请求头包含：

Accept: application/json

如果是JSON格式的请求体，同时添加：

Content-Type: application/json

3. 路由缓存过期 #

如果之前生成过路由缓存，可能导致新添加的API路由未被正确加载。

解决方案 #

执行命令清除路由缓存：

php artisan route:clear

之后可通过以下命令确认路由列表中存在POST /api/dp和POST /api/dj路由：

php artisan route:list

4. 控制器缺少对应处理方法 #

虽然apiResource会自动生成store方法的路由，但如果DPController或DJController中未实现store方法，也可能导致路由匹配异常。需确保控制器中存在对应方法：

// DPController 示例
public function store(StoreDPRequest $request)
{
    $dokumen = DokumenPribadi::create($request->validated());
    return new DPResource($dokumen);
}

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