Android React Native日志文件创建失败（EPERM权限错误）求助

核心原因分析 #

你遇到的EPERM (Operation not permitted)错误，主要和Android 10+的分区存储机制以及权限申请流程不完整有关——即便在Manifest中声明了权限，也需要符合不同Android版本的权限规则才能正常写入外部存储。

具体排查与修复步骤 #

1. 匹配Android版本的权限规则 #

• Android 10（API 29）及以上：WRITE_EXTERNAL_STORAGE权限仅能访问媒体文件，无法在自定义目录（如estate_logs/transaction/normal_logs）创建非媒体文件。
• Android 11（API 30）及以上：MANAGE_EXTERNAL_STORAGE是特殊权限，不能通过常规动态权限申请获取，必须引导用户到系统设置手动开启"所有文件访问权限"，且Google Play对使用该权限的应用有严格审核要求，非必要不建议使用。

2. 补全动态权限申请流程 #

即便在Manifest中声明了权限，危险权限（如WRITE_EXTERNAL_STORAGE）需要在运行时动态申请，你的代码缺少这一步：

// 在LoggingModule初始化前调用该方法申请权限
private void requestStoragePermissions() {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
        String[] permissions = {Manifest.permission.WRITE_EXTERNAL_STORAGE};
        if (ContextCompat.checkSelfPermission(getReactApplicationContext(), permissions[0]) != PackageManager.PERMISSION_GRANTED) {
            Activity currentActivity = getCurrentActivity();
            if (currentActivity != null) {
                ActivityCompat.requestPermissions(currentActivity, permissions, 1001);
            }
        }
    }
}

注意：React Native环境中要确保调用时当前Activity已初始化，避免空指针。

3. 推荐使用应用专属外部存储目录（无需额外权限） #

最稳妥的方案是放弃公共外部存储目录，改用应用专属的外部存储目录——这类目录不需要申请WRITE_EXTERNAL_STORAGE权限，且卸载应用时会自动清理：
修改路径定义：

// 替换原来的LOG_DIR和TRANSACTION_LOG_DIR
public static final String LOG_DIR = getReactApplicationContext().getExternalFilesDir(null).getAbsolutePath() + DIRECTORY_SEPARATOR + "estate_logs";
public static final String TRANSACTION_LOG_DIR = LOG_DIR + DIRECTORY_SEPARATOR + "transaction";

这个路径格式通常为/storage/emulated/0/Android/data/[你的应用包名]/files/estate_logs/transaction，系统默认授予读写权限。

4. 若必须使用公共目录，处理MANAGE_EXTERNAL_STORAGE权限（Android 11+） #

如果一定要用公共外部存储目录，针对Android 11+需引导用户手动授权：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
    if (!Environment.isExternalStorageManager()) {
        Intent intent = new Intent(Settings.ACTION_MANAGE_APP_ALL_FILES_ACCESS_PERMISSION);
        intent.setData(Uri.parse("package:" + getReactApplicationContext().getPackageName()));
        getReactApplicationContext().startActivity(intent);
    }
}

⚠️ 注意：Google Play会拒绝非必要使用该权限的应用，仅文件管理器、备份类等核心功能需全存储访问的应用可通过审核。

5. 简化文件创建逻辑 #

你的文件创建逻辑可简化，createNewFile()会自动处理文件不存在的情况，无需提前判断：

try {
    // 返回true表示文件新建成功，false表示文件已存在
    logFile.createNewFile();
} catch (IOException e) {
    Log.e("LoggingModule", "创建日志文件失败", e);
}

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