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() 调用前，于主模块顶层同步发起权限请求，并确保后续逻辑仅在授权通过后执行。以下是经过验证的重构方案：
PatentPal专利申请写作
AI软件来为专利申请自动生成内容
下载
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）。遵循此三步，即可稳定实现跨版本文件读写能力。