本文详解如何在 kivy + python for android 项目中正确申请并使用外部存储读写权限，解决 permissionerror: [errno 13] permission denied 问题，涵盖声明、运行时请求、路径适配及最佳实践。
本文详解如何在 kivy + python for android 项目中正确申请并使用外部存储读写权限，解决 permissionerror: [errno 13] permission denied 问题，涵盖声明、运行时请求、路径适配及最佳实践。
在 Android 6.0（API 23）及以上系统中，即使已在 buildozer.spec 中声明了 READ_EXTERNAL_STORAGE 和 WRITE_EXTERNAL_STORAGE 权限，仍需在应用运行时显式请求用户授权——这是导致你的 Kivy 应用启动即崩溃的根本原因。错误日志 PermissionError: [Errno 13] Permission denied 明确表明：代码尝试在未获授权时直接访问 /storage/emulated/0/（即公共外部存储），而 Android 拒绝了该操作。
✅ 正确做法：运行时权限请求必须早于任何文件 I/O 操作
关键原则是：权限请求必须在 App 实例创建和任何文件系统调用之前完成，且需处理异步授权结果。你原代码中将 request_permissions() 放在 build() 方法内（即 UI 构建阶段）存在两大缺陷：
- build() 可能被多次调用，但权限只需请求一次；
- 更严重的是：mkdir() 和 open() 在 request_permissions() 返回前就已执行（该函数是异步的），此时权限尚未授予，必然失败。
以下是修正后的标准实现：
import kivy from kivy.app import App from kivy.uix.label import Label from kivy.utils import platform from pathlib import Path # 仅在 Android 平台导入并请求权限（避免桌面端报错） if platform == "android": from android.permissions import request_permissions, Permission, check_permission from android.storage import primary_external_storage_path class MyApp(App): def build(self): text = f"User data dir: {App.get_running_app().user_data_dir}n" self.label = Label(text=text) if platform == "android": # ✅ 步骤1：检查是否已获权限（可选，提升体验） if not (check_permission(Permission.READ_EXTERNAL_STORAGE) and check_permission(Permission.WRITE_EXTERNAL_STORAGE)): # ✅ 步骤2：在 build() 开头请求权限（但注意：仍需异步处理） # ⚠️ 注意：request_permissions 是异步的，后续操作必须等待回调！ self.request_storage_permissions() else: self.create_file_safely() else: self.create_file_safely() return self.label def request_storage_permissions(self): """安全地请求存储权限，并在授权后执行文件操作""" from android.permissions import request_permissions, Permission from android import mActivity def callback(permissions, results): # permissions 和 results 是并行列表，results[i] 表示 permissions[i] 是否被授予 if all(results): self.create_file_safely() else: self.label.text += "❌ 权限被拒绝，无法创建文件。n" # 异步请求，callback 将在用户响应后触发 request_permissions( [Permission.READ_EXTERNAL_STORAGE, Permission.WRITE_EXTERNAL_STORAGE], callback ) def create_file_safely(self): """在确认获得权限后执行文件操作""" try: folder_path = Path(primary_external_storage_path(), "my_kivy_app") folder_path.mkdir(parents=True, exist_ok=True) file_path = folder_path / "test.txt" with open(file_path, "w", encoding="utf-8") as f: f.write("Hello from Kivy on Android! ?n") self.label.text += f"✅ 文件已创建：{file_path}n" except Exception as e: self.label.text += f"❌ 文件操作失败：{e}n" # ✅ 最佳实践：主入口处提前请求权限（推荐方案） if __name__ == '__main__': if platform == "android": from android.permissions import request_permissions, Permission # 在 App 启动前同步请求（阻塞至用户响应完毕） # ⚠️ 注意：此方式会短暂显示权限弹窗再启动 UI，用户体验更可控 request_permissions([Permission.READ_EXTERNAL_STORAGE, Permission.WRITE_EXTERNAL_STORAGE]) MyApp().run()? 配置补充说明（buildozer.spec）
确保你的 buildozer.spec 包含以下配置（注意格式与权限名称大小写）：
# 必须声明（用于生成 AndroidManifest.xml） android.permissions = READ_EXTERNAL_STORAGE, WRITE_EXTERNAL_STORAGE, INTERNET # 推荐添加（适配 Android 11+ Scoped Storage 的过渡兼容） android.api = 33 android.ndk = 25c p4a.branch = develop # 使用较新版本以更好支持新 API? 重要提示（Android 11+）：从 Android 11（API 30）起，WRITE_EXTERNAL_STORAGE 对公共目录（如 /sdcard/Download）的访问被大幅限制。若需长期存储，建议改用 app_storage_path()（应用私有目录，无需权限）或使用 MediaStore API。本方案适用于兼容旧版及调试场景。
? 总结要点
- 权限声明 ≠ 权限授予：buildozer.spec 中的配置仅生成清单，运行时请求不可或缺；
- 请求时机决定成败：权限请求必须在任何 open()、mkdir() 等 I/O 操作之前完成，且需通过回调确认结果；
- 避免主线程阻塞：request_permissions() 是异步的，切勿假设调用后立即生效；
- 路径选择有讲究：优先使用 app_storage_path()（无需权限，数据随 App 卸载清除）；若必须用共享存储，请确保目标路径符合 Scoped Storage 规则；
- 始终异常捕获：Android 权限模型动态性强，务必用 try/except 包裹文件操作。
遵循以上方案，你的 Kivy Android 应用即可稳定实现文件读写功能。