Android应用无法读取外部存储目录文件问题求助

DevOps 小满

2026-6-16

Android应用无法访问外部公共目录问题解决

问题概述

开发的Android应用需要读取设备中照片、视频、音乐等公共目录文件，但调用list()方法获取下载目录文件列表时返回null，且无任何报错，无法访问下载、图片等应用外部目录。

问题根源分析

从提供的代码来看，主要存在以下几个问题：

权限配置不完整：READ_EXTERNAL_STORAGE权限设置了maxSdkVersion="28"，导致Android 10+（API 29及以上）无法获取该权限；同时缺少Android 11+所需的MANAGE_EXTERNAL_STORAGE权限。
权限申请逻辑未启用：代码中权限检查和申请的代码被注释，导致应用从未向用户请求存储访问权限。
存储API使用过时：Environment.getExternalStoragePublicDirectory()在Android 10开始被废弃，分区存储机制下直接通过File操作公共目录会被限制。
路径获取不规范：直接使用new File("sdcard")这种硬编码路径，不同设备的存储路径可能存在差异，且无权限访问。

解决方案

1. 修复权限配置与申请

修改Manifest.xml权限配置

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools">

    <!-- 适配Android 9及以下的读取权限 -->
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
    <!-- 适配Android 11+的全存储访问权限，需用户手动授权 -->
    <uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE" />

    <application
        android:requestLegacyExternalStorage="true" <!-- 兼容Android 10的分区存储 -->
        android:allowBackup="true"
        android:dataExtractionRules="@xml/data_extraction_rules"
        android:fullBackupContent="@xml/backup_rules"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/Theme.New_proj">
        <activity
            android:name=".MainActivity"
            android:exported="true">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>

</manifest>

实现权限申请逻辑

修改MainActivity.java，添加权限检查与申请：

public class MainActivity extends AppCompatActivity {
    private Button bt;
    private static final int REQUEST_STORAGE_PERMISSION = 100;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        EdgeToEdge.enable(this);
        setContentView(R.layout.activity_main);
        ViewCompat.setOnApplyWindowInsetsListener(findViewById(R.id.main), (v, insets) -> {
            Insets systemBars = insets.getInsets(WindowInsetsCompat.Type.systemBars());
            v.setPadding(systemBars.left, systemBars.top, systemBars.right, systemBars.bottom);
            return insets;
        });

        bt = findViewById(R.id.button);
        bt.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View view) {
                checkStoragePermission();
            }
        });
    }

    private void checkStoragePermission() {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
            // Android 11+，检查是否有全存储权限
            if (!Environment.isExternalStorageManager()) {
                Intent intent = new Intent(Settings.ACTION_MANAGE_APP_ALL_FILES_ACCESS_PERMISSION);
                intent.setData(Uri.parse("package:" + getPackageName()));
                startActivityForResult(intent, REQUEST_STORAGE_PERMISSION);
            } else {
                // 权限已获取，访问文件
                accessDownloadFiles();
            }
        } else {
            // Android 10及以下，检查读取权限
            if (ContextCompat.checkSelfPermission(this, Manifest.permission.READ_EXTERNAL_STORAGE)
                    != PackageManager.PERMISSION_GRANTED) {
                ActivityCompat.requestPermissions(this,
                        new String[]{Manifest.permission.READ_EXTERNAL_STORAGE},
                        REQUEST_STORAGE_PERMISSION);
            } else {
                accessDownloadFiles();
            }
        }
    }

    private void accessDownloadFiles() {
        // 方式一：使用File（仅在权限生效时可用）
        File downloadDir = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOADS);
        if (downloadDir.exists() && downloadDir.isDirectory()) {
            String[] files = downloadDir.list();
            System.out.println(Arrays.toString(files));
        } else {
            System.out.println("下载目录不存在或无权限访问");
        }

        // 方式二：推荐使用MediaStore（适配分区存储）
        queryFilesViaMediaStore();
    }

    private void queryFilesViaMediaStore() {
        Uri uri = MediaStore.Downloads.EXTERNAL_CONTENT_URI;
        String[] projection = {MediaStore.Downloads.DISPLAY_NAME};
        Cursor cursor = getContentResolver().query(uri, projection, null, null, null);
        if (cursor != null) {
            List<String> fileNames = new ArrayList<>();
            while (cursor.moveToNext()) {
                String name = cursor.getString(cursor.getColumnIndexOrThrow(MediaStore.Downloads.DISPLAY_NAME));
                fileNames.add(name);
            }
            cursor.close();
            System.out.println("MediaStore查询到的文件：" + fileNames.toString());
        }
    }

    @Override
    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
        if (requestCode == REQUEST_STORAGE_PERMISSION) {
            if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                accessDownloadFiles();
            } else {
                System.out.println("存储权限被拒绝");
            }
        }
    }

    @Override
    protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
        super.onActivityResult(requestCode, resultCode, data);
        if (requestCode == REQUEST_STORAGE_PERMISSION) {
            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
                if (Environment.isExternalStorageManager()) {
                    accessDownloadFiles();
                } else {
                    System.out.println("全存储权限被拒绝");
                }
            }
        }
    }
}

2. 关键说明

Android 11+权限：MANAGE_EXTERNAL_STORAGE权限无法通过代码直接申请，必须引导用户到应用设置页面手动开启，代码中已实现跳转逻辑。
分区存储适配：推荐使用MediaStoreAPI访问公共媒体文件，这是Android 10+官方推荐的方式，无需依赖requestLegacyExternalStorage，兼容性更好。
权限回调处理：必须实现onRequestPermissionsResult和onActivityResult来处理用户的权限选择结果，确保权限通过后再执行文件访问操作。

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

Android应用无法读取外部存储目录文件问题求助

问题概述 #

问题根源分析 #

解决方案 #

1. 修复权限配置与申请 #