Laravel 模型加密字段长度不足导致解密失败的解决方案-php教程-PHP中文网

Laravel 模型加密字段长度不足导致解密失败的解决方案

Laravel 的 encrypted 类型自动加密字段时，密文长度远超明文，若数据库列长度不足（如 VARCHAR(191)），会导致解密时抛出 “The payload is invalid” 错误；根本解决方法是将加密字段改为 TEXT 类型。

laravel 的 `encrypted` 类型自动加密字段时，密文长度远超明文，若数据库列长度不足（如 `varchar(191)`），会导致解密时抛出 “the payload is invalid” 错误；根本解决方法是将加密字段改为 `text` 类型。

在 Laravel 中使用 $casts = ['field' => 'encrypted'] 是一种便捷的模型级自动加解密机制，但其底层依赖 Illuminate\Encryption\Encrypter 对数据进行 AES-256-CBC 加密，并附加消息认证码（MAC）和序列化开销。这意味着即使原始明文很短（例如 10 字符密码），加密后输出也包含 Base64 编码的 IV、密文和 MAC，整体长度显著膨胀。

以 Laravel 9 为例，实测表明：

明文长度 50 字符 → 密文约 288 字符
明文长度 100 字符 → 密文约 372 字符
明文长度 200 字符 → 密文达 568 字符

而 VARCHAR(191) 最大仅支持 191 字节（非字符），远不足以容纳典型加密载荷，造成数据被截断——存储时看似成功，读取时因完整性校验失败（MAC 不匹配或 JSON 解析异常）而触发 DecryptException。

✅ 正确解决方案如下：

laravel-specialist

精通 Laravel 10+，遵循现代 PHP 实践的 Laravel 专家。擅长优雅语法、Eloquent ORM、队列系统及企业级特性...

下载

1. 迁移数据库字段类型（关键步骤）
将 service_username、service_password 等加密字段从 VARCHAR(191) 升级为 TEXT：

// 在 migration 文件中
Schema::table('integrations', function (Blueprint $table) {
    $table->text('service_username')->change();
    $table->text('service_password')->change();
    $table->text('service_practice_pin')->change();
});

⚠️ 注意：change() 方法需启用 doctrine/dbal 扩展（composer require doctrine/dbal），否则会报错。

2. 验证加密行为（可选调试）
可在 tinker 或测试中验证加密长度边界：

use Illuminate\Support\Facades\Crypt;

$plain = str_repeat('x', 200);
$encrypted = Crypt::encrypt($plain);
echo strlen($encrypted); // 输出类似 568
dd(base64_decode($encrypted)); // 查看原始二进制结构（含 IV + ciphertext + MAC）

3. 无需修改模型访问逻辑
修复字段长度后，直接使用 $model->service_username 即可自动解密，不再需要手动 decrypt() 或自定义 accessor——Laravel 的 cast 机制会在获取属性时透明解密。

❌ 错误做法示例（不推荐）：

// 不要这样做：绕过 cast 手动 decrypt，易引发重复解密或异常
public function getDecryptedServiceUsernameAttribute()
{
    return decrypt($this->attributes['service_username']); // ❌ 可能对已解密值再次解密
}

? 总结：