本文详解 android 应用中向内部存储写入 json 文件的正确方法，指出常见错误（如路径误用、流未刷新、权限与模式混淆），并提供基于 gson 的稳定、可复用的实现方案。
本文详解 android 应用中向内部存储写入 json 文件的正确方法，指出常见错误（如路径误用、流未刷新、权限与模式混淆），并提供基于 gson 的稳定、可复用的实现方案。
在 Android 中将数据序列化为 JSON 并持久化到文件，看似简单，却极易因环境差异（如文件系统权限、上下文作用域、流管理）导致“静默失败”——无异常抛出，但文件内容未更新。你提供的三段尝试均存在关键问题，下面逐一解析并给出工业级可靠写法。
❌ 常见错误分析
Method 1（gson.toJson(..., new FileWriter(file))）：
FileWriter 默认使用平台默认编码（可能非 UTF-8），且 FileWriter 不适用于 Android 内部私有目录的健壮写入；更严重的是，FileWriter 不保证立即刷盘，且未显式调用 flush() 或 close()（虽 gson.toJson 内部会关闭，但异常路径下易遗漏）。Method 2（openFileOutput(path, ...)）：
openFileOutput() 仅接受文件名（如 "test.json"），不接受完整路径。传入绝对路径（如 /data/data/.../test.json）会导致 FileNotFoundException 或静默失败——这是最隐蔽的坑！Method 3（new FileWriter(file) 直接写字符串）：
同样绕过 Android 文件系统安全模型；若 file 所在目录不存在（如子目录嵌套），FileWriter 不会自动创建父目录，直接抛 IOException（但你 catch 了却未 log，导致“看不见的错误”）。额外陷阱：file.setWritable(true) 在 Android 10+（Scoped Storage）及内部私有目录中完全无效且多余——getFilesDir() 返回的路径天然可写，调用该方法无实际作用。
Android Remote Control下载远程控制 Android 设备，支持截图、自动化操作手机 App 等功能。本应用使用 uiautomator2 作为底层框架，通过 ADB 连接设备，用户无需 Root（1）查看手机屏幕；（2）自动化操作手机 App；（3）远程安装/卸载应用……
✅ 正确写法：安全、可靠、可扩展
以下代码是经过验证的生产就绪方案，使用 FileOutputStream + Gson，兼顾编码控制、目录创建、异常反馈与资源安全释放：
private void writeJsonToFile(Object data, String fileName) {
File file = new File(getFilesDir(), fileName); // ✅ 正确：仅传文件名，根目录由 getFilesDir() 提供
try {
// 确保父目录存在（尤其当 fileName 含子目录时，如 "data/player.json"）
if (!file.getParentFile().exists()) {
file.getParentFile().mkdirs();
}
if (!file.exists()) {
file.createNewFile(); // ✅ 显式创建文件（避免 FileNotFoundException）
}
// 使用 UTF-8 编码写入 JSON 字符串
String json = new Gson().toJson(data);
FileOutputStream fos = new FileOutputStream(file);
fos.write(json.getBytes(StandardCharsets.UTF_8)); // ✅ 明确指定 UTF-8
fos.flush(); // ✅ 强制刷入磁盘
fos.close();
Log.d("JSON_WRITE", "Success: " + file.getAbsolutePath());
Toast.makeText(this, "Saved to " + fileName, Toast.LENGTH_SHORT).show();
} catch (IOException e) {
Log.e("JSON_WRITE", "Failed to write JSON", e);
Toast.makeText(this, "Save failed: " + e.getMessage(), Toast.LENGTH_LONG).show();
}
}调用示例：
// 写入字符串
writeJsonToFile("gjsanhfhj", "test.json");
// 写入对象（推荐）
PlayerData player = new PlayerData();
player.gold = 100;
player.wins = 5;
writeJsonToFile(player, "player.json");? 关键要点总结
- ✅ 永远用 getFilesDir() 作为根目录，再拼接文件名（而非 getAbsolutePath() + 手动拼路径）；
- ✅ openFileOutput() 只接收纯文件名，不可传路径；若需路径操作，请统一使用 FileOutputStream；
- ✅ 必须处理 getParentFile().mkdirs() 和 createNewFile()，避免因目录缺失导致失败；
- ✅ 显式指定 StandardCharsets.UTF_8，防止中文乱码；
- ✅ 调用 flush() + close()（或使用 try-with-resources）确保数据落盘；
- ✅ 添加 Log 和用户反馈（Toast），让“静默失败”变为“可见问题”。
遵循以上实践，即可彻底解决 Android JSON 文件写入失效问题，让数据持久化真正可靠、可调试、可维护。
