Laravel资源路由传非整数ID时如何返回404替代50X错误

Laravel默认路由模型绑定会直接将传入的路由参数作为查询条件执行数据库查询，传入非数字类型ID时，PostgreSQL这类强类型数据库会因字段类型不匹配抛出SQL错误，默认异常处理未将该类错误归类为资源未找到场景，因此返回500类服务端错误。

方案1：路由层添加参数格式约束（性能最优） #

资源路由注册时直接对ID参数添加数字格式校验，不符合格式的请求会在路由匹配阶段直接返回404，不会触发数据库查询：

// routes/web.php
use Illuminate\Support\Facades\Route;

Route::resource('notes', NoteController::class)
    ->whereNumber('note');

注：Laravel 8及以上版本可直接使用whereNumber方法约束参数为纯数字，无需手写正则；notes资源对应的默认路由参数为单数形式note，如果自定义过路由参数名请对应调整。低版本Laravel可使用->where(['note' => '[0-9]+'])实现相同效果。

方案2：全局异常捕获（统一处理所有同类场景） #

如果项目中所有模型的主键ID都是数字类型，可直接在全局异常处理中捕获该类SQL错误，统一返回404响应，无需逐个路由添加约束：
打开app/Exceptions/Handler.php，在register方法中添加如下渲染回调：

// 文件顶部引入依赖类
use Illuminate\Database\QueryException;
use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;

public function register()
{
    $this->renderable(function (QueryException $e) {
        // PostgreSQL 数字类型输入不匹配错误码为22P02，使用MySQL的场景可根据实际报错的SQLSTATE值调整判断条件
        if ($e->getCode() === '22P02' && str_contains($e->getMessage(), 'invalid input syntax for type bigint')) {
            throw new NotFoundHttpException('请求的资源不存在');
        }
    });
}

方案3：单模型自定义绑定逻辑（仅针对Note模块生效） #

如果只需要调整笔记模块的绑定逻辑，不影响其他资源路由，可以在app/Providers/RouteServiceProvider.php的boot方法中单独定义Note模型的解析规则：

// 文件顶部引入依赖
use App\Models\Note;
use Illuminate\Support\Facades\Route;

public function boot()
{
    Route::bind('note', function ($value) {
        // 非数字参数直接返回404
        if (!ctype_digit((string)$value)) {
            abort(404);
        }
        return Note::findOrFail($value);
    });
}

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