Laravel解码PASETO Token遇Base64字符错误问题求解

错误原因 #

你遇到的报错是因为SymmetricKey::fromEncodedString()方法要求传入base64编码的对称密钥，但你直接传入了明文密钥YELLOW SUBMARINE, BLACK WIZARDRY，导致底层base64解码逻辑触发非法字符异常。

解决方案 #

1. 处理密钥格式 #

将明文密钥转换为base64编码格式，或者直接使用预先编码好的密钥值（推荐后者，避免重复编码操作）。

2. 修正代码并存储Payload到会话 #

以下是修正后的完整代码，包含会话存储逻辑：

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use ParagonIE\Paseto\Parser;
use ParagonIE\Paseto\Keys\SymmetricKey;

class DashboardController extends Controller
{
    public function index()
    {
        $pasetoToken = 'v2.local.2P2TzwkaMdoz2Y8NFTsB_kgHWG9lPNNCRzdqGtuZlUbYuz0iMuDrby8utgqfs0g1pGxmSe_8cTCgiJ_xFkPAY7tllw.bnVsbA';
        
        // 方式1：明文密钥转base64（仅首次转换使用，之后建议直接用编码后的值）
        $plainSecret = 'YELLOW SUBMARINE, BLACK WIZARDRY';
        $base64EncodedKey = base64_encode($plainSecret);
        
        // 方式2：直接使用预先计算好的base64编码密钥（推荐）
        // $base64EncodedKey = 'WUVMTE9XIFNVQk1BUklORSwgQkxBQ0sgV0laQVJEUlk=';

        try {
            // 使用base64编码后的密钥创建SymmetricKey实例
            $key = SymmetricKey::fromEncodedString($base64EncodedKey);

            // 解析并验证PASETO Token
            $decodedToken = (new Parser())
                ->setKey($key)
                ->parse($pasetoToken);

            // 获取Payload数据
            $payload = $decodedToken->getClaims();
            
            // 将Payload存入Laravel会话
            session()->put('auth_user', [
                'user_id' => $payload['user_id'],
                'role' => $payload['role']
            ]);

            // 输出验证后的Payload（可根据需求删除）
            var_dump($payload);
        } catch (\ParagonIE\Paseto\Exception\PasetoException $e) {
            echo 'PASETO验证失败: ' . $e->getMessage();
        } catch (\Exception $e) {
            echo '异常: ' . $e->getMessage();
        }

        return view('dashboard.index');
    }
}

关键说明 #

• 密钥格式要求：SymmetricKey::fromEncodedString()严格要求输入base64编码的密钥，这是PASETO库的规范，必须遵守。
• 会话存储：验证成功后，通过session()->put()将Payload中的核心字段存入会话，后续可通过session('auth_user.user_id')或session('auth_user.role')快速获取。
• 一致性校验：确保解码使用的密钥与生成Token时的密钥完全一致，包括编码格式，否则会触发验证失败异常。

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