使用Laravel的Crypt门面加密URL中的ID时报"The payload is invalid"错误

问题场景 #

需要将Laravel应用的URL从http://127.0.0.1:8000/assessments/1/edit修改为包含加密ID的形式（如http://127.0.0.1:8000/assessments/encrypted-id/edit），使用Laravel的Crypt门面实现加密解密，但触发了"The payload is invalid"错误。

当前实现代码 #

控制器方法 #

use Illuminate\Support\Facades\Crypt;

public function edit($id) {
    $assessment = Assessment::findOrFail(Crypt::decrypt($id));
    return view('directories.assessments.edit', compact('assessment', 'id'));
}

Blade模板中的加密调用 #

<form action="{{ route('assessments.update', Crypt::encrypt($assessment->id)) }}" method="POST">

已尝试的排查步骤 #

• 执行php artisan key:generate生成新的应用密钥
• 确认已正确导入Illuminate\Support\Facades\Crypt

错误信息 #

The payload is invalid.

问题原因及解决方案 #

核心原因 #

Crypt生成的加密字符串包含/、+、=等URL敏感字符，直接放在URL中会被浏览器自动转码，导致解密时拿到的字符串与原加密串不一致，触发无效payload错误；另外如果加密和解密使用的APP_KEY不一致，也会出现该错误。

正确实现步骤 #

1. 对加密ID进行URL安全编码

使用Crypt::encryptString（推荐用于字符串加密）配合URL编码函数处理敏感字符：

• Blade模板加密编码：

<form action="{{ route('assessments.update', rawurlencode(Crypt::encryptString($assessment->id))) }}" method="POST">

• 控制器解码解密：

use Illuminate\Support\Facades\Crypt;

public function edit($id) {
    $decryptedId = Crypt::decryptString(rawurldecode($id));
    $assessment = Assessment::findOrFail($decryptedId);
    return view('directories.assessments.edit', compact('assessment'));
}

2. 确保加密解密使用同一APP_KEY

如果执行过key:generate，需要重新渲染页面生成新的加密URL——旧的加密串因密钥变更无法解密，必须全部替换。

3. 进阶：使用路由模型绑定自动解密

可以通过路由绑定简化解密逻辑，减少重复代码：

在App\Providers\RouteServiceProvider的boot方法中添加绑定：

use Illuminate\Support\Facades\Crypt;
use App\Models\Assessment;

public function boot()
{
    parent::boot();

    Route::bind('encryptedAssessment', function ($value) {
        return Assessment::findOrFail(Crypt::decryptString(rawurldecode($value)));
    });
}

修改路由定义：

Route::get('/assessments/{encryptedAssessment}/edit', [AssessmentController::class, 'edit'])->name('assessments.edit');

控制器方法可简化为：

public function edit(Assessment $assessment) {
    return view('directories.assessments.edit', compact('assessment'));
}

Blade模板仍使用之前的加密编码方式即可。

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