Android端Google Sheets预览CSV文件的编码异常问题

问题核心 #

你的场景存在典型的编码兼容性矛盾：

• 为解决MS Excel识别UTF-8 CSV时的特殊字符乱码问题，必须添加UTF-8 BOM（EF BB BF）
• 但Android端Google Sheets应用对带BOM的UTF-8 CSV处理存在缺陷，导致预览异常，而桌面端、网页版Sheets不受影响

可行解决方案 #

方案1：后端根据请求来源动态控制BOM添加 #

通过识别请求的User-Agent，判断是否为Android设备，仅对非Android请求添加BOM，避免影响Android端Sheets。

修改后端代码：

// 调整outputStream方法，增加是否写入BOM的参数
private StreamingOutput outputStream(byte[] bytes, boolean writeBom) {
    return outputStream -> {
        if (writeBom) {
            final byte[] bom = new byte[] { (byte) 239, (byte) 187, (byte) 191 };
            outputStream.write(bom);
        }
        outputStream.write(bytes);
        outputStream.flush();
    };
}

// 构建响应时，根据请求头判断是否添加BOM
public Response exportCsv(@Context HttpServletRequest request) {
    boolean isAndroid = request.getHeader("User-Agent").contains("Android");
    return Response.ok(outputStream(activitiesCSV, !isAndroid))
            .header(HttpHeaders.CONTENT_DISPOSITION, "attachment; filename=\"activities.csv\"")
            .header(HttpHeaders.CONTENT_TYPE, "text/csv; charset=utf-8")
            .build();
}

方案2：APP端下载后移除UTF-8 BOM #

在Android端保存文件前，检查并移除字节数组开头的BOM，再写入文件。

修改Android端Kotlin代码：

override suspend fun getDocument(file: File): File {
    val body = http.execute(
        call = { service.getDocument(...) },
        onError = { ... },
    )
    withContext(dispatchers.io) {
        val originalBytes = body.source().readByteArray()
        // 检查并移除开头的UTF-8 BOM
        val processedBytes = if (originalBytes.size >= 3 
            && originalBytes[0] == 0xEF.toByte() 
            && originalBytes[1] == 0xBB.toByte() 
            && originalBytes[2] == 0xBF.toByte()) {
            originalBytes.copyOfRange(3, originalBytes.size)
        } else {
            originalBytes
        }
        file.writeBytes(processedBytes)
    }
    return file
}

方案3：优化Intent的MIME类型指定 #

在打开文件时，明确指定text/csv; charset=utf-8作为MIME类型，帮助Android端Sheets正确识别编码，避免依赖系统推断。

修改Intent创建代码：

fun createFileIntent(context: Context, file: File): Intent {
    val contentUri = file.getContentUri(context)
    // 明确指定带编码的MIME类型
    val type = "text/csv; charset=utf-8"
    val intent = Intent(ACTION_VIEW)

    intent.setDataAndType(contentUri, type)
    intent.flags = FLAG_GRANT_READ_URI_PERMISSION
    return intent
}

补充说明 #

• 方案1和方案2是从根源解决BOM兼容性问题，方案3作为辅助优化
• 若选择方案2，需确保后端返回的CSV确实是UTF-8编码，避免移除BOM后导致其他应用（如Excel）出现乱码，此时可考虑APP端仅在打开Sheets时移除BOM，或者为Excel单独处理，但实现复杂度较高，推荐优先方案1

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