本文详解 android 中使用 gson 库将对象序列化为 json 并持久化到内部存储文件的正确方法，指出常见错误（如路径误用、流未刷新、权限与上下文问题），并提供可直接运行的安全写入示例。
本文详解 android 中使用 gson 库将对象序列化为 json 并持久化到内部存储文件的正确方法，指出常见错误（如路径误用、流未刷新、权限与上下文问题），并提供可直接运行的安全写入示例。
在 Android 中向 JSON 文件写入数据失败却无报错，是开发者常遇到的典型问题。根本原因往往不是逻辑错误，而是对 Android 文件系统机制的理解偏差。以下三点是关键误区：
- ❌ 错误使用 openFileOutput() 传入完整路径：Context.openFileOutput(filename, mode) 的 filename 参数仅接受文件名（如 "test.json"），而非绝对路径。若传入 "/data/data/.../test.json" 会抛出 IllegalArgumentException（有时被静默吞掉）；
- ❌ FileWriter 未调用 flush() 或未正确关闭：虽然 close() 隐含 flush，但若异常提前退出或资源未释放，内容可能滞留在缓冲区；
- ❌ 混淆内部存储路径构造方式：getFilesDir().getAbsolutePath() + "/test.json" 虽语法合法，但易引入斜杠重复或路径拼接风险；应优先使用 new File(getFilesDir(), "test.json")。
✅ 正确做法是：使用 FileOutputStream 配合 getFilesDir() 构造安全路径，并确保 JSON 字符串通过字节数组写入。以下是推荐实现：
private void writeJsonToFile() {
// 示例数据类（需有 public 字段或 getter）
class PlayerData {
int gold = 100;
int wins = 5;
int losses = 2;
}
Gson gson = new Gson();
PlayerData data = new PlayerData();
File file = new File(getFilesDir(), "test.json"); // ✅ 安全路径构造
try {
if (!file.exists()) {
file.createNewFile(); // ✅ 确保文件存在（尤其首次写入）
}
FileOutputStream fos = new FileOutputStream(file);
String json = gson.toJson(data);
fos.write(json.getBytes(StandardCharsets.UTF_8)); // ✅ 显式指定 UTF-8 编码
fos.flush(); // ✅ 强制刷入磁盘（防御性操作）
fos.close();
Toast.makeText(this, "JSON saved successfully", Toast.LENGTH_SHORT).show();
} catch (IOException e) {
e.printStackTrace();
Toast.makeText(this, "Save failed: " + e.getMessage(), Toast.LENGTH_LONG).show();
}
}
⚠️ 重要注意事项：
- 不要手动调用 file.setWritable(true)：Android 内部存储（getFilesDir()）下的文件默认私有且可写，此调用无效且可能误导；
- 始终指定字符集：getBytes(StandardCharsets.UTF_8) 替代 getBytes()，避免中文等 Unicode 字符乱码；
-
验证写入结果：可通过 adb shell 查看文件内容：
adb shell "run-as your.package.name cat files/test.json"
- 若需覆盖写入，FileOutputStream(file) 默认即覆盖模式；如需追加，请用 FileOutputStream(file, true)。
综上，摒弃 FileWriter 和错误路径的 openFileOutput()，坚持使用 FileOutputStream + getFilesDir() + Gson.toJson() 组合，即可稳定、可靠地完成 JSON 文件写入。
