Laravel Encrypter密钥错误：如何生成有效密钥？

错误原因 #

你遇到的密钥无效问题核心有两点：

1. 构造Encrypter时，直接传入了base64编码后的密钥字符串，但Encrypter构造函数需要的是解码后的原始二进制密钥。
2. 手动生成密钥时重复编码：Encrypter::generateKey()已经返回对应算法的原始二进制密钥，你再套一层base64_encode()会让密钥长度翻倍，完全不符合要求。

正确生成密钥的方式 #

方式1：Laravel项目用artisan命令（推荐） #

直接在终端运行官方命令，自动生成符合当前cipher配置的密钥，并存入.env文件：

php artisan key:generate

生成的APP_KEY格式为base64:xxx，Laravel会自动处理解码逻辑，无需手动操作。

方式2：单独使用Encrypter时手动生成 #

如果是在非Laravel项目中使用该加密组件，按以下步骤操作：

1. 生成对应算法的原始二进制密钥：

use Illuminate\Encryption\Encrypter;

// 对应你的AES-256-CBC配置
$rawKey = Encrypter::generateKey('AES-256-CBC');

2. 若要存储密钥，先进行base64编码，使用时再解码回原始字节：

// 编码后用于存储的字符串
$encodedKey = base64_encode($rawKey);

// 构造Encrypter时必须解码回原始二进制密钥
$encrypter = new Encrypter(base64_decode($encodedKey), 'AES-256-CBC');

或者用createFromConfig方法兼容Laravel的base64:前缀格式：

$encrypter = Encrypter::createFromConfig([
    'key' => 'base64:' . $encodedKey,
    'cipher' => 'AES-256-CBC',
]);

修复你当前的代码 #

如果想用现有APP_KEY（base64:evsLYhBx1UAKKervjVIt1aJK0KLHHIf0vETUeI0HaYc=），有两种修复方式：

1. 直接调用Laravel配置，自动处理解码：

$encrypter = new Encrypter(config('app.key'), config('app.cipher'));
// 更推荐用createFromConfig方法，兼容性更好
$encrypter = Encrypter::createFromConfig([
    'key' => config('app.key'),
    'cipher' => config('app.cipher'),
]);

2. 手动解码你传入的字符串：

$key = base64_decode("evsLYhBx1UAKKervjVIt1aJK0KLHHIf0vETUeI0HaYc=");
$encrypter = new Encrypter($key, 'AES-256-CBC');

关键规则 #

• AES-128系列（aes-128-cbc/gcm）需要16字节原始密钥，base64编码后为24字符（含填充）。
• AES-256系列（aes-256-cbc/gcm）需要32字节原始密钥，base64编码后为44字符（含填充）。
• Encrypter构造函数的第一个参数必须是原始二进制密钥，不能直接传base64编码字符串（除非用createFromConfig并带base64:前缀）。

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