Android API29设备无法写入/sdcard文件权限问题求助

嘿，我刚好碰到过一模一样的问题！这是Android 10（API 29）引入的**分区存储（Scoped Storage）**机制导致的——哪怕你已经申请了WRITE_EXTERNAL_STORAGE和READ_EXTERNAL_STORAGE权限，默认情况下也不能直接访问外部存储的根目录（比如/sdcard）。下面给你两种解决方案：

方案1：临时兼容旧存储模式（快速修复） #

如果你想快速让现有代码在API29上正常运行，可以在AndroidManifest.xml的<application>标签里添加android:requestLegacyExternalStorage="true"属性，强制Android 10使用旧的存储访问规则：

<application 
    android:allowBackup="true" 
    android:icon="@mipmap/ic_launcher" 
    android:label="@string/app_name" 
    android:roundIcon="@mipmap/ic_launcher_round" 
    android:supportsRtl="true" 
    android:theme="@style/AppTheme"
    android:requestLegacyExternalStorage="true"> <!-- 新增这一行 -->
    <!-- 你的activity配置 -->
</application>

这个方法能让你继续沿用原来的路径写入逻辑，但要注意：在Android 11（API30）及以上版本，这个属性会被忽略，所以如果后续要适配更高版本，还是得用方案2。

方案2：适配分区存储（推荐长期方案） #

分区存储是Android官方推荐的存储方式，更安全也更符合系统规范。你可以选择两种路径写入：

2.1 写入公共目录（比如Downloads、Pictures） #

如果你希望文件在卸载应用后仍然保留，可以写入系统公共目录，比如Downloads：

修改你的writeTest方法，替换路径为公共Downloads目录：

void writeTest() {
    Log.wtf( "TAG", "====================================================================" );
    // 获取公共Downloads目录
    File downloadsDir = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOADS);
    String fn = downloadsDir.getAbsolutePath() + "/testwrite.txt";
    Log.wtf( "TAG", "--> TEST: Writing.. " + fn );
    
    File file = new File( fn );
    try {
        Log.wtf( "TAG", "--> Writing.." );
        FileWriter fw = new FileWriter(file, false);
        fw.write( "Test Doc !!!!!" );
        fw.close();
        Log.wtf( "TAG", "--> Success.." );
    } catch( IOException e) {
        e.printStackTrace();
        Log.wtf( "TAG", "--> Error.." );
        Log.wtf( "TAG", e.toString() );
    }
}

2.2 写入应用专属外部存储 #

如果文件不需要在应用卸载后保留，可以写入应用专属的外部存储目录，这个路径在Android Q及以上不需要额外的读写权限：

void writeTest() {
    Log.wtf( "TAG", "====================================================================" );
    // 获取应用专属外部存储目录
    File externalFilesDir = getExternalFilesDir(null);
    String fn = externalFilesDir.getAbsolutePath() + "/testwrite.txt";
    Log.wtf( "TAG", "--> TEST: Writing.. " + fn );
    
    File file = new File( fn );
    try {
        Log.wtf( "TAG", "--> Writing.." );
        FileWriter fw = new FileWriter(file, false);
        fw.write( "Test Doc !!!!!" );
        fw.close();
        Log.wtf( "TAG", "--> Success.." );
    } catch( IOException e) {
        e.printStackTrace();
        Log.wtf( "TAG", "--> Error.." );
        Log.wtf( "TAG", e.toString() );
    }
}

为什么旧版本设备没问题？ #

因为在Android 9（API28）及以下，系统没有启用分区存储，应用申请了读写权限后可以直接访问外部存储的任意路径，包括/sdcard根目录。而Android 10开始默认开启分区存储，限制了这种直接访问。

内容的提问来源于stack exchange，提问作者Peter Lee