Uppy结合Laravel上传文件失败：解密异常问题求助

这个The payload is invalid解密异常通常是因为Laravel收到的CSRF令牌格式不正确，大概率是令牌传递过程中出现了编码问题，或者验证逻辑不匹配。下面是一步步的排查和解决方法：

1. 先确认前端CSRF令牌的正确性 #

首先确保你的页面<head>里已经正确生成了Laravel的CSRF meta标签：

<meta name="csrf-token" content="{{ csrf_token() }}">

然后在浏览器控制台打印令牌内容，检查是否是正常的字符串：

console.log($('meta[name="csrf-token"]').attr('content'));

如果输出的令牌带有URL编码的字符（比如%2B之类的），那问题就出在这里——Laravel需要的是原始令牌，而不是编码后的版本。

2. 调整Uppy的XHRUpload配置 #

修改你的Uppy配置，对令牌进行URL解码后再放入请求头：

const options = {
    endpoint: '/parts/image-upload',
    formData: true, // 确保以表单数据格式发送文件
    headers: {
        'X-XSRF-TOKEN': decodeURIComponent($('meta[name="csrf-token"]').attr('content')),
    },
};
uppyDashboard.use(XHRUpload, options);

decodeURIComponent会把编码后的令牌还原成原始格式，这样Laravel就能正常解密验证了。

3. 备选方案：通过表单字段传递CSRF令牌 #

如果请求头传递还是有问题，可以尝试把令牌作为表单字段发送，Laravel的VerifyCsrfToken中间件会自动识别_token字段：

const options = {
    endpoint: '/parts/image-upload',
    formData: true,
    meta: {
        _token: $('meta[name="csrf-token"]').attr('content'),
    },
};
uppyDashboard.use(XHRUpload, options);

这种方式不需要处理请求头，直接让Uppy把令牌和文件一起打包成表单数据发送，兼容性更好。

4. 后端路由与中间件检查 #

• 确保你的上传路由/parts/image-upload是在web中间件组下（而不是api组），因为web中间件包含了CSRF验证逻辑，api组默认关闭了CSRF验证，如果你在api组里发送CSRF令牌，Laravel反而会尝试解密一个不需要验证的令牌，导致异常。
• 检查app/Http/Middleware/VerifyCsrfToken.php里的$except数组，不要把上传路由加进去——如果排除了这个路由，Laravel不会验证CSRF，但你又发送了令牌，也可能引发解密错误。

5. 最后检查Laravel的加密密钥 #

如果以上方法都没用，确认你的.env文件里的APP_KEY是正确的，没有被意外修改。如果APP_KEY失效，所有加密的会话数据（包括CSRF令牌）都会无法解密。可以用以下命令重新生成密钥（注意：生产环境会导致之前加密的数据失效，谨慎操作）：

php artisan key:generate

按照这些步骤排查，基本就能解决这个解密异常问题了。

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