真机调试可下载图片，发布后提示无权限

Question

在真机调试时图片可正常下载，但发布后提示“无权限”，常见于Android应用的存储权限配置不当。开发阶段，应用可能通过调试模式获取临时文件访问权限，但正式发布后系统严格校验运行时权限（如Android 10+的Scoped Storage限制）。若未适配REQUEST_INSTALL_PACKAGES、WRITE_EXTERNAL_STORAGE或未正确使用MediaStore API保存图片，将导致保存失败并报权限错误。此外，部分厂商定制系统对存储权限有额外限制，加剧此问题。

Answer 1

1. 问题背景与现象分析

在Android应用开发过程中，开发者常遇到一个典型问题：调试阶段图片可正常下载并保存至设备存储，但一旦应用发布到正式环境（如Google Play或国内各大应用市场），用户反馈“无权限”错误，导致图片无法保存。该现象的核心在于调试模式与发布模式下系统对存储权限的处理差异。

• 开发阶段使用调试签名APK，部分设备允许临时绕过部分运行时权限限制。
• 发布版本采用正式签名，系统严格执行Android 6.0+的运行时权限模型及Android 10引入的Scoped Storage机制。
• 尤其在Android 11及以上版本中，直接访问外部存储根目录被禁止，必须通过MediaStore API或分区存储规范操作文件。

2. 权限体系演进：从传统权限到作用域存储

Android 版本	关键变更	对应权限要求	影响范围
Android 6.0 (API 23)	引入运行时权限	WRITE_EXTERNAL_STORAGE 需动态申请	所有外存写入操作
Android 10 (API 29)	引入 Scoped Storage	限制访问公共目录	应用私有目录隔离
Android 11 (API 30)	默认禁用 MANAGE_EXTERNAL_STORAGE	需特殊声明并审核	第三方文件管理器类应用
Android 13 (API 33)	细化照片/视频/音频权限	READ_MEDIA_IMAGES 等细分权限	媒体文件访问控制

3. 核心技术原因剖析

1. 未适配 Android 10+ 的 Scoped Storage：仍使用 Environment.getExternalStoragePublicDirectory() 获取路径，在 API 29+ 上已被废弃。
2. 缺少运行时权限请求流程：仅在 Manifest 中声明 WRITE_EXTERNAL_STORAGE，未在代码中调用 ActivityCompat.requestPermissions()。
3. 忽略 MediaStore 插入流程：正确做法是通过 ContentResolver.insert() 获取 Uri 后再写入流。
4. REQUEST_INSTALL_PACKAGES 权限缺失：若涉及 APK 下载安装，需在 AndroidManifest.xml 显式声明此权限。
5. 厂商定制系统限制：华为、小米、OPPO 等厂商对自启动、存储访问有额外管控策略，需引导用户手动授权。
6. targetSdkVersion 设置过低：若 targetSdkVersion ≤ 28，系统不会强制启用 Scoped Storage，掩盖真实问题。
7. 缓存路径误用：将下载文件存于 getCacheDir()，可能被系统自动清理。
8. FileProvider 配置错误：分享文件时未正确设置 provider paths，导致跨应用访问失败。
9. 异步线程中执行 UI 操作：权限回调后未切回主线程更新 UI 或继续下载逻辑。
10. 混淆或ProGuard规则误删权限相关类：发布包因代码压缩导致权限检查逻辑异常。

4. 解决方案与最佳实践

// 示例：使用 MediaStore 保存图片（兼容 Android 10+）
private void saveImageToGallery(Context context, Bitmap bitmap) {
    ContentValues values = new ContentValues();
    values.put(MediaStore.Images.Media.DISPLAY_NAME, "downloaded_image.jpg");
    values.put(MediaStore.Images.Media.MIME_TYPE, "image/jpeg");
    values.put(MediaStore.Images.Media.RELATIVE_PATH, Environment.DIRECTORY_PICTURES + "/MyApp");

    Uri uri = context.getContentResolver().insert(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, values);
    if (uri != null) {
        try (OutputStream os = context.getContentResolver().openOutputStream(uri)) {
            bitmap.compress(Bitmap.CompressFormat.JPEG, 90, os);
            Toast.makeText(context, "图片已保存", Toast.LENGTH_SHORT).show();
        } catch (IOException e) {
            Log.e("SaveImage", "Failed to save image", e);
            Toast.makeText(context, "保存失败：" + e.getMessage(), Toast.LENGTH_LONG).show();
        }
    }
}

5. 调试与发布差异的根源图解

graph TD A[开发调试模式] --> B{是否使用调试签名?} B -- 是 --> C[部分设备放宽权限校验] B -- 否 --> D[严格遵循权限策略] C --> E[临时获得文件写入能力] D --> F[触发 PERMISSION_DENIED] G[发布版本] --> H[正式签名 + targetSdkVersion ≥ 29] H --> I[强制启用 Scoped Storage] I --> J[必须使用 MediaStore API] J --> K[否则报“无权限”错误]

6. 厂商适配建议清单

• 小米手机：需在“安全中心”手动开启“文件读写权限”和“自启动”。
• 华为EMUI：关闭“权限自动管理”，设置为“根据使用情况推荐”或手动授权。
• OPPO / Realme：进入“权限隐私”→“应用权限管理”→开启“存储”权限。
• Vivo / iQOO：在“应用管理”中找到APP，授予“读写存储”权限。
• 三星 One UI：虽基于原生Android，但仍建议检测 PermissionManagerService 状态。

建议在首次启动时跳转至系统设置页面，提示用户完成必要授权：

val intent = Intent(Settings.ACTION_APPLICATION_DETAILS_SETTINGS)
intent.data = Uri.fromParts("package", packageName, null)
startActivity(intent)