本文深入探讨了qr码扫描时字符错乱的常见问题，特别是当jwt等包含特殊字符的数据在非utf-8编码的扫描器中被错误解析的情况。文章分析了问题根源，并提出将数据进行base64编码作为一种通用且高效的解决方案，确保数据在不同扫描环境下的兼容性和正确性，同时提供了实践指导和注意事项。
问题现象与背景
在开发过程中，使用qrcode.js等库生成的QR码，其内容通常是结构化的数据，例如JSON Web Token (JWT)。然而，在某些场景下，当通过物理QR码扫描器读取这些QR码时，会发现扫描到的数据与原始数据存在字符差异。一个典型的例子是，原始JWT中的连字符'-'在扫描后可能被替换为撇号'''。这种字符错乱会导致数据解析失败，例如JWT签名验证不通过。
值得注意的是，这种问题往往具有选择性。相同的QR码可能在手机应用或某些特定扫描器上能正确读取，但在另一部分扫描器上则出现问题。这表明问题并非出在QR码本身或生成逻辑上，而更可能与扫描设备的字符编码处理机制有关。
根本原因分析
经过深入调查，这类字符错乱问题的核心在于QR码扫描器对字符编码的支持不一致。
现代互联网应用普遍采用UTF-8编码来处理文本，因为它能支持全球范围内的所有字符。然而，一些老旧或配置特殊的QR码扫描设备可能不支持UTF-8，而是使用其他ISO编码（如ISO-8859-1、GBK等）。当QR码中包含的JWT等数据是UTF-8编码，且其中含有这些非UTF-8编码不支持的“特殊字符”（即使是像连字符'-'这样在ASCII中常见的字符，也可能在特定编码转换或解释环境下出现问题），扫描器在尝试将其解码为自身支持的编码时，就可能发生字符替换或错误解释。
具体来说，JWT包含三个部分，由点号.分隔，每个部分都是Base64URL编码的。Base64URL编码本身只使用ASCII字符集中的特定字符（A-Z, a-z, 0-9, '-', '_', '='），这些字符在大多数编码中都应是安全的。然而，如果扫描器在读取QR码的原始二进制数据流后，在将其转换为字符串时，强制应用了不兼容的字符集，或者在内部处理流程中存在编码转换错误，就有可能导致这些字符被误读。例如，当一个非UTF-8兼容的扫描器遇到一个本应是UTF-8的字节序列时，它可能会将其解释为某个不同的字符，从而导致数据损坏。
解决方案
要彻底解决这类因字符编码不兼容导致的扫描问题，主要有两种思路：
统一扫描器配置（理想但复杂）： 理论上，最直接的方法是确保所有使用的QR码扫描器都配置为支持UTF-8编码。然而，这在实际操作中往往难以实现，特别是当涉及到多种型号的扫描设备或第三方硬件时，我们可能无法控制其固件设置或字符集配置。
数据预处理：Base64编码（推荐的实用方案）： 更通用和可靠的方法是在生成QR码之前，对要承载的数据（如JWT）进行Base64编码。Base64编码的原理是将任意二进制数据转换成一个只包含ASCII字符集（A-Z, a-z, 0-9, +, /, =) 的字符串。由于这些字符在几乎所有字符编码方案中都具有一致的表示，因此可以有效地规避因扫描器字符编码不兼容而引发的问题。
Base64编码实践
以下是如何在生成和读取QR码时应用Base64编码的示例：
1. 生成QR码前对数据进行Base64编码：
假设你有一个原始的JWT字符串，你需要先将其编码为Base64字符串，然后将这个Base64字符串作为QR码的内容。
// 原始的JWT字符串
const originalJwt = "eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJ7XCJ0YXJqZXRhXCI6XCIqKioqNCoqKioqKioqKlwiLFwibm9tXCI6XCIqKioqKioqKioqKioqKlwifSIsImlhdCI6MTY4NjMwODcwODk5MX0.IajSQzRdC3PkxI4opTbwk-bqcCE-75z9whYQwtZ2nFwVLGjHZRbTcjC1dy-jyTpPbVsWimQU96jxynopepCXQ";
// 在JavaScript中，可以使用btoa()函数进行Base64编码
// 注意：btoa()只能编码ASCII字符串。如果原始数据包含非ASCII字符，
// 需要先将其转换为UTF-8编码的二进制字符串，例如：
// const encodedData = btoa(encodeURIComponent(originalJwt).replace(/%([0-9A-F]{2})/g,
// function toSolidBytes(match, p1) {
// return String.fromCharCode('0x' + p1);
// }));
// 但对于JWT，其本身Base64URL编码后的内容已是ASCII安全，直接btoa通常可行。
const base64EncodedJwt = btoa(originalJwt);
console.log("Base64 编码后的JWT:", base64EncodedJwt);
// 使用 qrcode.js 生成 QR 码
// var qrcode = new QRCode(document.getElementById("qrcode"), {
// text: base64EncodedJwt, // 将Base64编码后的字符串作为QR码内容
// width: 128,
// height: 128,
// colorDark : "#000000",
// colorLight : "#ffffff",
// correctLevel : QRCode.CorrectLevel.H
// });
// 生成的QR码现在包含的是Base64编码后的字符串，它只包含ASCII安全字符。2. 扫描QR码后对数据进行Base64解码：
当扫描器成功读取到QR码的内容后，你会在接收端（例如前端应用或后端服务）得到Base64编码的字符串。此时，你需要将其解码回原始的JWT字符串。
// 假设这是从QR码扫描器接收到的Base64编码字符串 const scannedBase64Data = "ZXlKaGJHY2lPaUpJVXpJMU5pSXNJblJwY0NJNklpSXdPRE0wTkRFNE1qQXdNVFkxTVRVek1pSXNJbkp2YkdsaWVDSTZJbWt4aWJpMXpYQzB4S2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS2lvS
