如何使用npm jose库生成签名JWT并完成令牌校验？

1. 最优密钥对生成方案 #

针对你需要对接PKCS证书体系的需求，分两种场景选择最优方案：

• 开发调试/临时运行时生成：直接使用jose库内置的generateKeyPair方法，该方法自动适配Node.js runtime，不需要手动处理WebCrypto的算法、权限参数，可避免大量参数配置类踩坑。
• 生产环境/正式对接PKCS体系：提前用openssl生成标准PEM格式密钥对，应用启动时导入使用，方便密钥管理、证书轮换，完全适配后续PKCS证书体系对接需求。
  openssl生成PEM密钥对命令如下：

# 生成2048位RSA私钥
openssl genrsa -out private.pem 2048
# 从私钥导出公钥
openssl rsa -in private.pem -pubout -out public.pem
# 可选：将私钥转为PKCS8格式（适配更通用的证书体系要求）
openssl pkcs8 -topk8 -inform PEM -in private.pem -out private_pkcs8.pem -nocrypt

2. 完整JWT签名与验证操作示例 #

以下示例基于jose v4及以上版本实现：

2.1 运行时生成密钥对的实现 #

import { generateKeyPair, SignJWT, jwtVerify } from 'jose'

// 生成RS256算法对应的密钥对
const { publicKey, privateKey } = await generateKeyPair('RS256')

// 签名生成JWT
const jwt = await new SignJWT({
  iss: '你的签发方标识',
  aud: '你的接收方标识',
  data: '自定义业务字段'
})
.setProtectedHeader({ alg: 'RS256' }) // 必须指定和密钥匹配的算法
.setExpirationTime('1h') // 设置过期时间
.sign(privateKey) // 传入私钥签名

// 验证JWT
const verifyResult = await jwtVerify(jwt, publicKey, {
  issuer: '你的签发方标识',
  audience: '你的接收方标识'
})
console.log(verifyResult.payload) // 校验通过后可直接获取声明内容

2.2 导入外部PEM密钥的实现 #

import { importPKCS8, importSPKI, SignJWT, jwtVerify } from 'jose'
import fs from 'fs'

// 读取PEM文件内容
const privateKeyPem = fs.readFileSync('./private_pkcs8.pem', 'utf-8')
const publicKeyPem = fs.readFileSync('./public.pem', 'utf-8')

// 转换为jose可识别的KeyLike类型
const privateKey = await importPKCS8(privateKeyPem, 'RS256')
const publicKey = await importSPKI(publicKeyPem, 'RS256')

// 后续签名、验证逻辑和2.1完全一致
const jwt = await new SignJWT({ iss: 'xxx', aud: 'xxx' })
.setProtectedHeader({ alg: 'RS256' })
.setExpirationTime('1h')
.sign(privateKey)

过往报错核心原因 #

• 直接传PEM字符串/Buffer未转换：jose要求非对称密钥必须先通过内置的导入方法转为KeyLike类型，不能直接传原始文本或Buffer
• 算法不匹配：使用SignJWT时未通过setProtectedHeader指定与密钥对应的alg参数（RSA签名对应RS256/RS384/RS512），导致密钥与签名算法校验不通过
• WebCrypto参数配置错误：手动调用WebCrypto生成密钥时，算法配置、usages参数需要和签名算法严格对应，jose内置方法已经封装了这部分逻辑，不需要手动处理

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