Swift如何在iOS端正确解码含非UTF-8编码的Base64字符串

完全可以在iOS设备本地完成这类Base64字符串的全流程解码，根本不需要把内容发送到服务端处理。你之前遇到的解码失败问题，和Base64承载的内容是否为UTF-8编码没有任何关系，本质是用了存在兼容缺陷的老旧API才导致的。

• Base64是纯粹的二进制编码格式，本身根本不关心解码后的字节流是UTF-8文本、Windows-1252文本、ISO-8859-1文本，甚至是没有文本结构的加密密钥原始二进制。它的解码逻辑只识别标准规范内的65个有效字符（大小写字母、数字、+、/、填充符=），整个解码过程和字节流的编码格式完全无关。
• 你遇到的所有解码失败，全部来自两个旧API的设计缺陷：
  • 调用老旧的NSData类Base64解码接口时，哪怕加了IgnoreUnknownCharacters选项，也会触发内置的截断逻辑，面对完全合法的Base64字符串时，也可能直接返回空结果；
  • 不添加该选项时，这个旧API对Base64字符串的校验逻辑过于严苛，对填充符、字符集的判断和其他主流语言的标准实现存在差异，直接返回nil。网上流传的Stack Overflow旧片段、第三方gist代码，大多都在复用这个有问题的老接口，所以你抄下来一跑就全失败，根本不是你的应用场景有什么特殊限制。

• 二进制解码环节直接用系统原生Data类的现代接口，解码逻辑和Python、PHP、Java的标准Base64实现完全一致，没有兼容性差异：

  // 传入待解码的Base64字符串
  guard let decodedBinary = Data(
      base64Encoded: yourBase64String,
      options: [.ignoreUnknownCharacters]
  ) else {
      // 处理解码失败分支
      return
  }
  // 到这一步就已经拿到完整的原始二进制内容了，不会因为字节流是非UTF-8编码就解码失败
  

  这里要特别注意：新版Data接口下的.ignoreUnknownCharacters选项，和旧NSData的同名选项行为完全不一样——它只会跳过字符串里夹杂的非Base64字符（比如换行、冗余空格），不会对合法的Base64字符串做截断，根本不会出现返回空值的问题。
• 如果需要把解码得到的二进制内容转成对应编码的字符串，直接选匹配的文本编码就行，不需要强行用UTF-8转码：

  // 转成ISO-8859-1编码文本（对Windows-1252内容有高度兼容性）
  let decodedText = String(data: decodedBinary, encoding: .isoLatin1)
  

用上述原生接口解码你提供的两个测试Base64字符串，得到的二进制结果和Python、Java等其他语言环境下的解码结果完全一致，和主流在线Base64解码工具的输出内容完全匹配，不存在必须上传到服务端才能解码的场景。

• 千万别把Base64解码和文本转码混成一个环节：Base64只负责把编码后的字符串还原成原始二进制，从来不会主动校验二进制是不是合法的UTF-8文本；之前的解码失败从来不是“Base64不支持非UTF8内容”，纯粹是用了有兼容缺陷的老旧接口而已。
• 后续再遇到Base64解码返回nil的问题，先排查是不是在用已经废弃的NSData旧解码接口，替换成系统原生的Data接口后，绝大多数兼容问题都会直接解决。

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