Android Studio中Assets文件保存到设备存储仅首次可用问题

核心原因分析 #

1. 权限丢失：首次安装时用户授予存储权限，卸载重装后系统会重置权限，而代码未做权限检查与申请，导致写入操作被拒绝。
2. 分区存储限制（Android 10+）：从API 29开始默认启用分区存储，直接访问Environment.getExternalStorageDirectory()指向的公共目录（如Documents）需要特殊权限，未适配则写入失败。
3. 遗留文件权限冲突：卸载应用时公共目录下的旧文件不会被删除，重装后的新应用可能无修改旧文件的权限，导致覆盖写入失败。

具体排查步骤 #

1. 查看Logcat日志：e.printStackTrace()会输出具体异常（如PermissionDeniedException或FileNotFoundException），直接定位问题类型。
2. 验证权限状态：在系统设置中检查应用的存储权限是否开启，卸载重装后权限默认处于关闭状态。

解决方案 #

方案1：适配权限申请流程

在代码中添加权限检查与申请逻辑，确保写入前已获取权限：

public class GKL10_pre extends AppCompatActivity {
    private Button button;
    private static final int PERMISSION_REQUEST_CODE = 100;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_gkl10_pre);

        button = findViewById(R.id.B_GKL10_FILES);
        button.setOnClickListener(view -> {
            if (hasStoragePermission()) {
                copyAssetsBatch();
            } else {
                requestStoragePermission();
            }
        });
    }

    private boolean hasStoragePermission() {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
            return Environment.isExternalStorageManager();
        } else {
            return ContextCompat.checkSelfPermission(this, Manifest.permission.WRITE_EXTERNAL_STORAGE)
                    == PackageManager.PERMISSION_GRANTED;
        }
    }

    private void requestStoragePermission() {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
            try {
                Intent intent = new Intent(Settings.ACTION_MANAGE_APP_ALL_FILES_ACCESS_PERMISSION);
                intent.setData(Uri.parse("package:" + getPackageName()));
                startActivityForResult(intent, PERMISSION_REQUEST_CODE);
            } catch (Exception e) {
                Intent intent = new Intent(Settings.ACTION_MANAGE_ALL_FILES_ACCESS_PERMISSION);
                startActivityForResult(intent, PERMISSION_REQUEST_CODE);
            }
        } else {
            ActivityCompat.requestPermissions(this,
                    new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE},
                    PERMISSION_REQUEST_CODE);
        }
    }

    @Override
    protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
        super.onActivityResult(requestCode, resultCode, data);
        if (requestCode == PERMISSION_REQUEST_CODE && Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
            if (Environment.isExternalStorageManager()) {
                copyAssetsBatch();
            } else {
                Toast.makeText(this, "未获取存储权限，无法保存文件", Toast.LENGTH_SHORT).show();
            }
        }
    }

    @Override
    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
        if (requestCode == PERMISSION_REQUEST_CODE) {
            if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                copyAssetsBatch();
            } else {
                Toast.makeText(this, "未获取存储权限，无法保存文件", Toast.LENGTH_SHORT).show();
            }
        }
    }

    private void copyAssetsBatch() {
        copyAsset("file1.pdf");
        copyAsset("file2.pdf");
        copyAsset("file3.pdf");
        copyAsset("file4.pdf");
    }

    // 原copyAsset、copyFile方法保持不变
}

同时在AndroidManifest.xml中添加权限声明：

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

<application
    ...
    android:requestLegacyExternalStorage="true">

方案2：使用应用专属外部存储（推荐）

无需申请额外权限，文件会随应用卸载自动删除，避免权限冲突：
修改copyAsset方法中的路径：

private void copyAsset(String filename){
    // 替换为应用专属Documents目录
    File dir = getExternalFilesDir(Environment.DIRECTORY_DOCUMENTS);
    if(!dir.exists()) {
        dir.mkdirs();
    }
    AssetManager assetManager = getAssets();
    InputStream in = null;
    OutputStream out = null;
    try {
        in = assetManager.open(filename);
        File outFile = new File(dir, filename);
        // 若文件已存在，先删除旧文件
        if (outFile.exists()) {
            outFile.delete();
        }
        out = new FileOutputStream(outFile);
        copyFile(in, out);
        Toast.makeText(this, "Saved!", Toast.LENGTH_SHORT).show();
    } catch (IOException e) {
        e.printStackTrace();
        Toast.makeText(this, "Failed!", Toast.LENGTH_SHORT).show();
    } finally {
        // 原关闭流逻辑保持不变
    }
}

此方案无需修改权限声明，兼容性更好。

方案3：处理文件覆盖问题

如果必须使用公共Documents目录，在写入前删除旧文件：

File outFile = new File(dirPath, filename);
if (outFile.exists()) {
    outFile.delete();
}
out = new FileOutputStream(outFile);

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