Laravel 8更新国家数据时country_name字段Unique唯一验证不生效如何解决

问题根因 #

当前验证不生效的核心原因：你使用的POST路由api/v1/core/updateCountry没有携带{country}路由参数，FormRequest中$this->country无法通过隐式路由模型绑定获取到待更新的国家ID，ignore()方法传入空值等于没有忽略当前记录，所以只要提交的国家名称已存在（包括当前记录本身的旧名称）就会触发重复校验错误。

最优实现方案 #

方案1：调整为RESTful路由（推荐） #

符合接口开发规范，后续维护成本更低

• 第一步：修改路由定义，改用PUT方法并携带国家ID路由参数

Route::put('api/v1/core/countries/{country}', [\App\Http\Controllers\Api\V1\Core\CountryController::class, 'updateCountry'])
    ->name('core.country.update')
    ->middleware('api');

• 第二步：调整FormRequest验证规则，明确指定忽略的主键字段，兼容表主键非id的场景

public function rules()
{
    return [
        'country_name' => [
            'required',
            'string',
            'min:2',
            'max:100',
            \Illuminate\Validation\Rule::unique('countries', 'name')->ignore($this->route('country'), 'id')
        ],
    ];
}

方案2：保留原POST路由（兼容现有逻辑） #

如果不想改动现有前端调用逻辑，可以通过请求参数传递待更新ID

• 第一步：前端提交更新请求时新增country_id参数，传入待更新的国家主键ID
• 第二步：调整FormRequest验证规则，从请求参数中取ID做忽略处理

public function rules()
{
    return [
        'country_id' => 'required|integer|exists:countries,id',
        'country_name' => [
            'required',
            'string',
            'min:2',
            'max:100',
            \Illuminate\Validation\Rule::unique('countries', 'name')->ignore($this->input('country_id'), 'id')
        ],
    ];
}

兜底优化 #

给countries表的name字段添加唯一索引，既可以提升唯一性校验的查询效率，也能作为数据库层面的兜底校验，避免应用层验证遗漏导致的脏数据：

ALTER TABLE `countries` ADD UNIQUE INDEX `countries_name_unique` (`name`);

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