Mac OS应用基于Swift实现Base64解码及OAuth2返回JWT解析求助

嘿，我来帮你搞定在macOS Swift应用里的Base64解码，尤其是处理你拿到的这段OAuth2授权服务器返回的内容。先提一句：你贴的这段字符串看起来是**JWT（JSON Web Token）**的载荷部分，它用的是URL安全的Base64编码，和标准Base64略有差异，我会分别讲通用解码和针对JWT的适配方案。

一、通用Base64解码方法 #

如果是标准Base64字符串，可以直接用Swift的Data类来处理，不过要注意补全填充字符（Base64要求长度是4的整数倍）：

import Foundation

func standardBase64Decode(_ base64Str: String) -> String? {
    // 补全必要的填充字符
    var paddedStr = base64Str
    let remainder = paddedStr.count % 4
    if remainder > 0 {
        paddedStr += String(repeating: "=", count: 4 - remainder)
    }
    
    // 解码为Data，再转成UTF-8字符串
    guard let data = Data(base64Encoded: paddedStr) else {
        print("Base64解码失败：无效的编码格式")
        return nil
    }
    return String(data: data, encoding: .utf8)
}

二、针对OAuth2返回的JWT解码 #

JWT的Base64是URL安全的，它把标准Base64里的+换成了-，/换成了_，还会去掉末尾的=。所以解码前需要先转换回标准格式：

import Foundation

func decodeJWTPayload(_ jwtPayloadStr: String) -> String? {
    // 第一步：将URL安全字符替换为标准Base64字符
    var standardBase64 = jwtPayloadStr
        .replacingOccurrences(of: "-", with: "+")
        .replacingOccurrences(of: "_", with: "/")
    
    // 第二步：补全填充字符
    let remainder = standardBase64.count % 4
    if remainder > 0 {
        standardBase64 += String(repeating: "=", count: 4 - remainder)
    }
    
    // 第三步：解码并转字符串
    guard let data = Data(base64Encoded: standardBase64) else {
        print("JWT载荷解码失败")
        return nil
    }
    return String(data: data, encoding: .utf8)
}

三、进阶：把解码后的JSON转成模型 #

解码后你会得到一段JSON字符串，用Swift的Codable可以轻松转成自定义模型，方便后续使用：

// 定义匹配返回字段的模型
struct OAuth2UserInfo: Codable {
    let email: String
    let updatedAt: Int
    let exp: Int
    let iat: Int
    let sub: String
    let iss: String
    let aud: [String]
    // 其他字段根据实际返回内容补充
    
    // 如果字段名和JSON里的蛇形命名不一致，需要映射
    enum CodingKeys: String, CodingKey {
        case email
        case updatedAt = "updated_at"
        case exp, iat, sub, iss, aud
    }
}

// 解析示例
let yourOAuth2Response = "eyJlbWFpbCI6InJ1dGdlckB5b3UuY28iLCJ1cGRhdGVkX2F0IjoxNTIzODcyOTE3LCJleHAiOjE1MjQwNDEyNzEsImlhdCI6MTUyNDA0MTE1MSwic3ViIjoicnV0Z2VyQFlPVS1URUNITk9MT0dJRVMtR1JPVVAtTElNSVRFRCIsImlzcyI6Imh0dHBzOi8veW91LXRlY2hub2xvZ2llcy1ncm91cC1saW1pdGVkLnZtd2FyZWlkZW50aXR5LmFzaWEvU0FBUy9hdXRoIiwiYXVkIjpbIllPVV9Qb3J0YWwiXSwiYXV0aF90aW1lIjoxNTI0MDMxNDUxLCJhenAiOiJZT1VfUG9ydGFsIiwiYXRfaGFzaCI6IkZ2a2Z4Q2lRTW1VWFhNREctc1BBN0EiLCJjX2hhc2giOiJOVF9zdGlmbEgtZktfSVBwSjExbVNRIiwiZ2l2ZW5f..."

// 先去掉末尾的省略号（如果是复制时截断的）
let cleanedResponse = yourOAuth2Response.replacingOccurrences(of: "...", with: "")

if let decodedJSON = decodeJWTPayload(cleanedResponse),
   let jsonData = decodedJSON.data(using: .utf8),
   let userInfo = try? JSONDecoder().decode(OAuth2UserInfo.self, from: jsonData) {
    print("用户邮箱：\(userInfo.email)")
    print("Token过期时间：\(Date(timeIntervalSince1970: TimeInterval(userInfo.exp)))")
    print("用户唯一标识：\(userInfo.sub)")
} else {
    print("解析失败，请检查输入字符串是否完整有效")
}

注意事项 #

• 如果你拿到的是完整的JWT（三段用.分隔），可以拆分后分别解码头部、载荷和签名（签名通常不需要转成字符串）。
• 确保输入的字符串没有多余的字符（比如你贴的末尾...），否则会导致解码失败。

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