Mac OS X Swift截图转Base64存MySQL后Android解码报Bad Base64错误

遇到这种跨平台Base64解码失败的问题，大概率是字符串在生成、存储或传输过程中出现了格式损坏，我帮你梳理几个最常见的原因和解决办法：

1. 修正Swift生成Base64时的换行符问题 #

Swift默认的base64EncodedString()方法会每隔64个字符插入换行符，这些换行符在MySQL存储后，Android解码时如果没处理就会触发"bad base64"错误。解决办法是生成不带换行的纯净Base64字符串：

// 假设screenshotData是你的截图Data对象
let cleanBase64 = screenshotData.base64EncodedString(options: .withoutLineBreaks)

2. 确保MySQL存储时不损坏Base64特殊字符 #

Base64包含+、/、=这些特殊字符，要确保MySQL字段不会修改它们：

• 字段类型选用LONGTEXT（避免TEXT长度限制导致截断）
• 字符集设置为utf8mb4（不要用latin1等不兼容的编码）

创建表的示例SQL：

CREATE TABLE screenshots (
    id INT AUTO_INCREMENT PRIMARY KEY,
    image_data LONGTEXT NOT NULL,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

另外，PHP存储时一定要用预处理语句，避免SQL转义破坏Base64字符串：

$pdo = new PDO("mysql:host=你的服务器地址;dbname=你的数据库;charset=utf8mb4", "用户名", "密码");
$base64Str = $_POST["image_base64"];
$stmt = $pdo->prepare("INSERT INTO screenshots (image_data) VALUES (?)");
$stmt->execute([$base64Str]);

3. 排查PHP接口返回时的额外输出污染 #

如果PHP接口返回Base64时，不小心输出了空格、BOM头或者其他多余内容，会导致Android拿到的字符串不完整或被污染。确保PHP文件开头没有多余的空格，输出时只返回纯净的内容：

// 不要有多余的echo或空格在代码开头
header("Content-Type: application/json");
$stmt = $pdo->prepare("SELECT image_data FROM screenshots WHERE id = ?");
$stmt->execute([$_GET["id"]]);
$result = $stmt->fetch(PDO::FETCH_ASSOC);
echo json_encode(["image" => $result["image_data"]]);
exit; // 确保没有后续无关输出

4. 调整Android解码的参数匹配格式 #

Android的Base64.decode()方法需要匹配字符串的格式，如果你的Base64没有换行，用Base64.NO_WRAP标识更合适，避免它尝试处理不存在的换行符：

String base64Str = // 从接口获取的Base64字符串
byte[] imageBytes = Base64.decode(base64Str, Base64.NO_WRAP);
Bitmap bitmap = BitmapFactory.decodeByteArray(imageBytes, 0, imageBytes.length);

建议先从Swift生成Base64的格式入手调整，这是这类问题最常见的诱因，再依次排查存储、传输和Android解码的环节，应该就能解决这个异常了。

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