Kivy Android 应用中正确申请存储权限以读写外部文件的完整教程

本文详解 Kivy 应用在 android 平台上动态申请 READ_EXTERNAL_STORAGE 和 WRITE_EXTERNAL_STORAGE 权限的规范流程，解决因权限未就绪导致的 PermissionError: [errno 13] Permission denied 问题，并提供可立即复用的代码结构与最佳实践。

本文详解 kivy 应用在 android 平台上动态申请 `read_external_storage` 和 `write_external_storage` 权限的规范流程，解决因权限未就绪导致的 `permissionerror: [errno 13] permission denied` 问题，并提供可立即复用的代码结构与最佳实践。

在 Kivy + Python for Android（p4a）构建的 Android 应用中，仅在 buildozer.spec 中声明权限是远远不够的。Android 6.0（API 23）起强制要求运行时动态请求危险权限（如存储访问），否则即使应用已安装，首次调用文件 I/O 操作仍会触发 PermissionError: [Errno 13] Permission denied —— 这正是你遇到的 /storage/emulated/0/folder 创建失败的根本原因。

关键误区在于：权限请求必须在 UI 线程启动前完成，且需等待用户授权回调完成后再执行敏感操作。你原代码中将 request_permissions() 放在 build() 方法内存在两大问题：

• build() 在 App 初始化后才执行，此时主线程可能已尝试访问文件系统；
• request_permissions() 是异步操作，mkdir() 和 open() 紧随其后执行，并未等待授权结果，导致权限尚未授予即发起文件操作。

✅ 正确做法是：在 MyApp().run() 调用前，于主模块顶层同步发起权限请求，并确保后续逻辑仅在授权通过后执行。以下是经过验证的重构方案：

import kivy from kivy.app import App from kivy.uix.label import Label from kivy.utils import platform from pathlib import Path  class MyApp(App):     def build(self):         text = "1" + App.get_running_app().user_data_dir + 'n'         self.label = Label(text=text)          if platform == "android":             from android.storage import primary_external_storage_path             folder_path = Path(primary_external_storage_path(), "folder")             # ✅ 此处不再请求权限，仅安全创建目录（需确保权限已获准）             try:                 folder_path.mkdir(parents=True, exist_ok=True)                 file = folder_path / "file.txt"                 with open(file, "w", encoding="utf-8") as tfile:                     tfile.write("test test")                 text += f"✓ 文件写入成功: {file}n"             except PermissionError:                 text += "✗ 权限不足，无法写入外部存储n"             except Exception as e:                 text += f"✗ 写入异常: {e}n"         else:             file = Path.home() / "file.txt"             with open(file, "w", encoding="utf-8") as tfile:                 tfile.write("test test")             text += f"✓ 桌面端写入: {file}n"          self.label.text = text         return self.label  # ✅ 关键：在 App 启动前统一处理权限请求 if __name__ == '__main__':     if platform == "android":         from android.permissions import request_permissions, Permission, check_permission         from android import mActivity          # 检查是否已拥有权限（避免重复弹窗）         if not (check_permission(Permission.READ_EXTERNAL_STORAGE) and                  check_permission(Permission.WRITE_EXTERNAL_STORAGE)):             # 异步请求，但需阻塞后续初始化直到用户响应（p4a 提供简易同步包装）             request_permissions([Permission.READ_EXTERNAL_STORAGE, Permission.WRITE_EXTERNAL_STORAGE])      # 启动应用（此时权限已确认就绪）     MyApp().run()

? 重要注意事项：

• buildozer.spec 配置必须保留（你已正确配置）：

  android.permissions = android.permission.READ_EXTERNAL_STORAGE, android.permission.WRITE_EXTERNAL_STORAGE, android.permission.INTERNET

• 对于 Android 10+（API 29），WRITE_EXTERNAL_STORAGE 在分区存储（Scoped Storage）下默认受限；若需访问公共目录（如 DCIM/、Downloads/），应改用 android.storage 提供的专用路径（如 shared_storage_path()）或申请 MANAGE_EXTERNAL_STORAGE（需 Google Play 特殊审核）。
• 建议始终使用 encoding=”utf-8″ 显式指定文本编码，避免跨平台乱码。
• 生产环境应添加授权失败后的降级策略（如改用 app_storage_path() 写入私有目录）。

✅ 总结：Kivy Android 存储权限的核心原则是——声明（buildozer.spec） + 动态申请（启动前） + 安全校验（运行时 try/catch）。遵循此三步，即可稳定实现跨版本文件读写能力。