Vapor集成JWT实现登录报bioConversionFailure错误如何解决

运行集成JWT能力的Vapor项目时触发顶层致命错误，报错信息如下：

Swift/ErrorType.swift:200: Fatal error: Error raised at top level:
JWTKit error: signing algorithm error: bioConversionFailure 2022-07-03
13:54:31.334671+0300 Run[29671:440363] Swift/ErrorType.swift:200:
Fatal error: Error raised at top level: JWTKit error: signing
algorithm error: bioConversionFailure

bioConversionFailure是JWTKit无法正确解析RSA密钥格式抛出的错误，触发原因来自两处操作失误：

1. 生成公钥的命令参数存在错误：-out myjwt.key pub 中输出文件名中间多了空格，openssl执行时会将原有的私钥文件myjwt.key作为输出文件覆盖，导致原私钥内容损坏
2. 直接用ssh-keygen生成的密钥默认可能为OpenSSH专属格式，头部标识为-----BEGIN OPENSSH PRIVATE KEY-----，JWTKit依赖的BoringSSL不支持该格式的解析，必须使用标准PKCS#1格式的PEM密钥。

• 先清理之前生成的损坏密钥文件，在项目目录执行：
  rm -f myjwt.key myjwt.key.pub pub
• 直接用openssl生成JWTKit兼容的4096位RSA私钥，不要使用ssh-keygen生成：
  openssl genrsa -out myjwt.key 4096
  生成的私钥为标准PKCS#1格式，头部标识为-----BEGIN RSA PRIVATE KEY-----，可被JWTKit正常识别
• 用正确命令导出对应公钥，注意输出文件名不要加多余空格：
  openssl rsa -in myjwt.key -pubout -outform PEM -out myjwt.key.pub
• 检查Vapor侧JWT配置：
  • 读取密钥时要完整读取文件全部内容，不要截断头尾的BEGIN/END标识行，不要引入多余空行或特殊字符
  • 若配置了私钥密码短语字段，需要清空对应配置，上述命令生成的私钥默认无密码
  • 签名算法选择RS256/RS384/RS512系列RSA算法，不要误用HS系列对称算法匹配RSA密钥

• 依赖引入：在项目Package.swift中添加Vapor官方JWT库依赖，对应Target中引入JWT模块即可
• 登录流程：校验用户账号密码通过后，使用RSA私钥签名生成Token，Payload中至少包含用户标识、过期时间字段，返回给前端存储
• 鉴权逻辑：需要登录态的接口，从请求头的Authorization字段提取Bearer Token，使用RSA公钥验证Token合法性，验证通过后提取Payload中的用户信息执行后续业务逻辑
• 环境配置：开发阶段可将密钥文件放在项目目录读取，生产环境禁止将密钥文件提交到代码仓库，通过环境变量注入密钥内容避免泄露
• 同类报错排查：如果修复后仍出现签名算法错误，优先检查密钥内容是否读取完整、签名和验证使用的密钥是否配对、密钥是否被额外修改过。

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