Android文件管理器SD卡文件无法删除/重命名问题求助

我开发的Android文件管理器在内部存储上的文件操作正常，但SD卡中的文件无法删除，重命名时只会弹出“Couldn't Rename!”提示失败。以下是实现长按弹出重命名、删除弹窗的相关代码，请帮忙排查问题：

Manifest #

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

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

    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"></uses-permission>

    <application
        android:requestLegacyExternalStorage="true"
        android:allowBackup="true"
        android:dataExtractionRules="@xml/data_extraction_rules"
        android:fullBackupContent="@xml/backup_rules"
        android:icon="@drawable/ic_folder"
        android:label="@string/app_name"
        android:roundIcon="@drawable/ic_launcher_background"
        android:supportsRtl="true"
        android:theme="@style/Theme.Files"
        tools:targetApi="31">
        <activity
            android:name=".MainActivity"
            android:exported="true">
            <intent-filter>
                <action android:name="android.intent.action.MAIN"/>
                <category android:name="com.pebble.intent.category.VR"/>
                <category android:name="android.intent.category.LAUNCHER"/>
            </intent-filter>
        </activity>

        <provider
            android:authorities="${applicationId}.provider"
            android:name="androidx.core.content.FileProvider"
            android:exported="false"
            android:grantUriPermissions="true">
            <meta-data
                android:name="android.support.FILE_PROVIDER_PATHS"
                android:resource="@xml/provider_path">

            </meta-data>
        </provider>
    </application>

</manifest>

Provider路径配置 #

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

    <external-path
        name="external"
        path="." />
    <external-files-path
        name="external_files"
        path="." />
    <cache-path
        name="cache"
        path="." />
    <external-cache-path
        name="external_cache"
        path="." />
    <files-path
        name="files"
        path="." />


    <root-path name="root" path="."/>

</paths>

核心代码 #

@Override
public void onFileLongClicked(File file, int position) {

    final Dialog optionDialog = new Dialog(getContext());
    optionDialog.setContentView(R.layout.option_dialog);
    optionDialog.setTitle("Select Options.");
    ListView options =(ListView) optionDialog.findViewById(R.id.List);
    CustomAdapter customAdapter = new CustomAdapter();
    options.setAdapter(customAdapter);
    optionDialog.show();

    options.setOnItemClickListener(new AdapterView.OnItemClickListener() {
        @Override
        public void onItemClick(AdapterView<?> adapterView, View view, int i, long l) {
            String selectItem = adapterView.getItemAtPosition(i).toString();

            switch (selectItem){
                
                case "Rename":

                    AlertDialog.Builder renameDialog = new AlertDialog.Builder(getContext());
                    renameDialog.setTitle("Rename File:");
                    final EditText name = new EditText(getContext());
                    renameDialog.setView(name);

                    renameDialog.setPositiveButton("OK", new DialogInterface.OnClickListener() {
                        @Override
                        public void onClick(DialogInterface dialogInterface, int i) {
                            String new_name = name.getEditableText().toString();
                            String extention = file.getAbsolutePath().substring(file.getAbsolutePath().lastIndexOf("."));
                            File current = new File(file.getAbsolutePath());
                            File destination = new File(file.getAbsolutePath().replace(file.getName(), new_name) + extention);
                            if (current.renameTo(destination)){
                                fileList.set(position, destination);
                                fileAdapter.notifyItemChanged(position);
                                Toast.makeText(getContext(), "Renamed!!", Toast.LENGTH_SHORT).show();
                            }
                            else{
                                Toast.makeText(getContext(), "Couldn't Rename!", Toast.LENGTH_SHORT).show();
                            }
                        }
                    });

                    renameDialog.setNegativeButton("Cancel", new DialogInterface.OnClickListener() {
                        @Override
                        public void onClick(DialogInterface dialogInterface, int i) {
                            optionDialog.cancel();
                        }
                    });
                    AlertDialog alertdialog_rename = renameDialog.create();
                    alertdialog_rename.show();

                    break;

                case "Delete":
                    AlertDialog.Builder deleteDialog = new AlertDialog.Builder(getContext());
                    deleteDialog.setTitle("Delete" + file.getName() + "?");
                    deleteDialog.setPositiveButton("Yes", new DialogInterface.OnClickListener() {
                        @Override
                        public void onClick(DialogInterface dialogInterface, int i) {
                            file.delete();
                            fileList.remove(position);
                            fileAdapter.notifyDataSetChanged();
                            Toast.makeText(getContext(), "Deleted!", Toast.LENGTH_SHORT).show();
                        }
                    });

                    deleteDialog.setNegativeButton("No", new DialogInterface.OnClickListener() {
                        @Override
                        public void onClick(DialogInterface dialogInterface, int i) {
                            optionDialog.cancel();
                        }
                    });

                    AlertDialog alertDialog_delete = deleteDialog.create();
                    alertDialog_delete.show();
                    break;

            }
        }
    });

}

问题原因与解决方案 #

1. Android 11+存储权限限制 #

• 从Android 11开始，WRITE_EXTERNAL_STORAGE权限已被废弃，即使申请该权限也无法直接操作SD卡公共目录的文件。requestLegacyExternalStorage仅对Android 10生效。
• 解决方法：
  • 针对Android 11+，添加MANAGE_EXTERNAL_STORAGE权限到Manifest：

    <uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE"
        tools:ignore="ScopedStorage" />
    

  • 代码中动态引导用户授予全文件访问权限：

    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
        if (!Environment.isExternalStorageManager()) {
            Intent intent = new Intent(Settings.ACTION_MANAGE_APP_ALL_FILES_ACCESS_PERMISSION);
            Uri uri = Uri.fromParts("package", getContext().getPackageName(), null);
            intent.setData(uri);
            startActivity(intent);
        }
    }
    

2. File API的局限性 #

• 传统File.renameTo()和File.delete()方法在SD卡上可能因文件系统权限、跨应用文件归属等问题失效。
• 解决方法：使用**存储访问框架(SAF)**替代File API操作SD卡文件：
  • 重命名示例：

    // 需先通过SAF获取文件的Uri
    ContentResolver resolver = getContext().getContentResolver();
    Uri parentUri = DocumentsContract.getParentDocument(resolver, fileUri);
    Uri newFileUri = DocumentsContract.buildDocumentUriUsingTree(parentUri,
        DocumentsContract.getDocumentId(parentUri) + "/" + new_name + extention);
    try {
        if (resolver.rename(fileUri, newFileUri)) {
            // 重命名成功逻辑
        } else {
            Toast.makeText(getContext(), "Couldn't Rename!", Toast.LENGTH_SHORT).show();
        }
    } catch (FileNotFoundException e) {
        e.printStackTrace();
    }
    

  • 删除示例：

    try {
        int result = getContext().getContentResolver().delete(fileUri, null, null);
        if (result > 0) {
            fileList.remove(position);
            fileAdapter.notifyDataSetChanged();
            Toast.makeText(getContext(), "Deleted!", Toast.LENGTH_SHORT).show();
        } else {
            Toast.makeText(getContext(), "Couldn't Delete!", Toast.LENGTH_SHORT).show();
        }
    } catch (Exception e) {
        e.printStackTrace();
    }
    

3. 代码逻辑缺陷 #

• 重命名时的字符串替换逻辑存在风险：若文件名包含父目录的部分字符，replace会错误替换路径内容，正确做法是通过父目录构建新文件：

  File parentDir = file.getParentFile();
  File destination = new File(parentDir, new_name + extention);
  

• 删除操作未判断是否成功，应增加结果校验：

  if (file.delete()) {
      fileList.remove(position);
      fileAdapter.notifyDataSetChanged();
      Toast.makeText(getContext(), "Deleted!", Toast.LENGTH_SHORT).show();
  } else {
      Toast.makeText(getContext(), "Couldn't Delete!", Toast.LENGTH_SHORT).show();
  }
  

4. FileProvider配置冗余 #

• <root-path>配置在Android 10+中无法绕过存储限制，且FileProvider主要用于文件共享，而非SD卡操作，建议移除该配置。

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