如何在 Android 中正确写入 JSON 文件-java教程-PHP中文网

如何在 Android 中正确写入 JSON 文件

本文详解 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");