仅Release构建下Android阻止访问应用专属内部存储及偏好设置问题

问题详情 #

Release构建（debuggable=false）下，应用出现写入成功但无法读取存储内容的异常：

• 应用专属内部存储、外部存储、缓存文件夹均无法读取已写入的文件，写入时无IO异常，目录/文件存在性检查返回true，但读取时directory.exists()返回false、listFiles()返回null；
• SharedPreferences写入时editor.commit()返回true，但读取时contains()返回false；
• Debug模式下所有存储操作正常；
• 问题在Android 10、11、13设备上均复现。

排查方向 #

1. 检查ProGuard/R8混淆规则 #

Release模式的混淆可能破坏存储相关标识：

• 存储类、文件名常量、SharedPreferences的key可能被混淆，导致读取时匹配失败。添加ProGuard规则保留相关内容：

  // 保留SharedPreferences的key常量
  -keepclassmembers class com.yourpackage.YourStorageClass {
      public static final String *;
  }
  // 保留文件操作相关的类和方法
  -keep class com.yourpackage.storage.** { *; }
  

• 注意：Release模式下assert语句会被自动移除，代码中的assert(outfile.exists());无法作为写入成功的判断依据。

2. 验证文件路径的正确性 #

避免通过PackageInfo获取存储路径，改用系统API确保路径可靠：

• 内部存储用context.getFilesDir()，外部专属存储用context.getExternalFilesDir(null)，这些API在Release模式下不会出现路径拼接错误；
• 在Release模式下添加日志（需配置build.gradle开启日志），打印写入和读取时的完整文件路径，确认两次路径完全一致。

3. 确认存储权限配置 #

针对外部存储：

• Android 10+应用专属外部存储无需权限，但如果Manifest中保留了旧权限，需限制SDK版本：

  <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="28" />
  

• 确保未使用非专属外部存储路径（比如直接操作Environment.getExternalStorageDirectory()）。

4. 排查SharedPreferences操作问题 #

• 确保SharedPreferences实例获取正确：使用context.getSharedPreferences("your_prefs_name", Context.MODE_PRIVATE)，避免使用其他模式；
• 写入后需确保editor.apply()或commit()执行完成，Release模式下进程可能快速重启，需确认数据已持久化；
• 检查key是否存在大小写或拼写差异，混淆可能导致key被修改。

5. 解决文件系统同步问题 #

写入时确保数据真正落盘：

• 在关闭流前调用fileOutputStream.flush()，确保缓存数据写入磁盘；
• 可改用Java NIO的Files.write()方法，该方法默认会同步数据到磁盘：

  Files.write(outfile.toPath(), json.getBytes(StandardCharsets.UTF_8));
  

6. 开启Release模式调试日志 #

配置build.gradle开启Release模式的日志输出，以便定位问题：

buildTypes {
    release {
        debuggable false
        minifyEnabled true
        proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        // 开启日志输出
        buildConfigField "boolean", "isLogs", "true"
    }
}

通过日志确认写入路径、读取路径是否一致，是否有隐藏的异常信息。

相关代码细节 #

获取应用数据目录的方法 #

private String getAppDataDirectory(final Context context){  //Get the app's data directory path.
    final PackageManager m = context.getPackageManager();
    try{
        final PackageInfo p = m.getPackageInfo(context.getPackageName(), 0);
        return p.applicationInfo.dataDir;
    }
    catch (android.content.pm.PackageManager.NameNotFoundException e) {
        if(isLogs){Log.e(TAG, "Cannot read package name: " + e.getMessage());}
        return null;
    }
}

文件写入代码 #

//First check projects folder exists and if not create it.
final File projectfolder = new File(appDataDirectory + File.separator + "Projects");
if(!projectfolder.exists()){
    if(!projectfolder.mkdirs()){ //Check for success
        if(isLogs){Log.e(TAG, "Failed to create project directory");}
        return false;
    }
}
final File outfile = new File(appDataDirectory + File.separator + "Projects", projectname + ".json");
try {
    final FileOutputStream fileOutputStream = new FileOutputStream(outfile);
    final OutputStreamWriter writer = new OutputStreamWriter(fileOutputStream);
    writer.write(json); //Output one Rect JSON per line
    writer.close();
    assert(outfile.exists());
    if(isLogs){Log.i(TAG, "Project Saved");}
    return true;
}
catch (IOException e) {
    if(isLogs){Log.e(TAG, "File write failed: " + e.toString());}
    return false;
}

其他存储方式测试代码 #

内部存储（不使用File对象）

final FileOutputStream fileOutputStream = context.openFileOutput(projectname + ".json", Context.MODE_PRIVATE);  
fileOutputStream.write(json.getBytes());

内部存储（使用File对象）

final File appSpecificDir  = context.getFilesDir(null);
final File outFile = new File(appSpecificDir, projectname + ".json");
final FileOutputStream fileOutputStream = new FileOutputStream(outFile);
fileOutputStream.write(json.getBytes());

外部存储

final File appSpecificExternalDir  = context.getExternalFilesDir(null);
final File outFile = new File(appSpecificExternalDir, projectname + ".json");
final FileOutputStream fileOutputStream = new FileOutputStream(outFile);
fileOutputStream.write(json.getBytes());

读取项目列表的方法 #

public static String[] listProjects(final String appDataDirectory){ //Get list of project files from the data folder.
    final File directory = new File(appDataDirectory + File.separator + "Projects");
    if(directory.exists()){ //The directory is not made until a project is saved
        final File[] files = directory.listFiles();
        if (files != null){ //Check for null to prevent error.
            final String[] projectslist = new String[files.length];
            String mystring;
            for (int i = 0; i < files.length; i++) {
                mystring = files[i].getName();
                projectslist[i] = mystring.substring(0, mystring.length() - 5); //Remove the ".json" to get the project name.
                if(isLogs){Log.i(TAG, "FileName:" + mystring);}
            }
            return projectslist;
        } else{
            if(isLogs){Log.i(TAG, "Projects folder is empty");}
            return null;
        }
    } else{
        if(isLogs){Log.i(TAG, "Projects folder does not exist");}
        return null;
    }
}

SharedPreferences读取代码 #

if (!myPreferences.contains(projectname)){
    if(isLogs){Log.e(TAG, "Project name " + projectname + "does not exist in saved preference.");}
    return false;
}

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