本文详解在 kivy + python for android（p4a）环境中，如何合规、可靠地申请并使用外部存储读写权限，解决 permissionerror: [errno 13] permission denied 问题，并避免因权限调用时机不当导致的崩溃或静默失败。
本文详解在 kivy + python for android（p4a）环境中，如何合规、可靠地申请并使用外部存储读写权限，解决 permissionerror: [errno 13] permission denied 问题，并避免因权限调用时机不当导致的崩溃或静默失败。
在 Android 6.0（API 23）及以上版本中，READ_EXTERNAL_STORAGE 和 WRITE_EXTERNAL_STORAGE 属于危险权限（dangerous permissions），仅在 buildozer.spec 中声明是远远不够的——必须在运行时显式请求用户授权，且必须在任何访问外部存储的操作之前完成授权。你遇到的 PermissionError 正是因为代码在未获授权前就尝试创建目录（folder_path.mkdir(...)），而此时系统已拒绝访问 /storage/emulated/0/。
✅ 正确的权限申请时机：启动早期 + 异步等待
关键原则：权限请求必须发生在 UI 初始化之前，且需确保授权完成后再执行文件操作。你原代码中将 request_permissions(...) 放在 build() 方法内存在两大缺陷：
- build() 在 Kivy 主循环启动后才执行，此时部分底层 Android API 可能尚未就绪；
- 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
import os
# 仅在 Android 平台导入 Android 模块（避免桌面端报错）
if platform == "android":
from android.permissions import request_permissions, check_permission, Permission
from android.storage import primary_external_storage_path
from jnius import autoclass
PythonActivity = autoclass('org.kivy.android.PythonActivity')
class MyApp(App):
def build(self):
# 权限检查：若已授权，直接构建 UI；否则显示提示或延迟加载
if platform == "android":
if not self._check_storage_permissions():
# 权限未授予，返回占位 Label 提示用户等待
return Label(text="正在请求存储权限...\n请稍候", halign="center", valign="middle")
# ✅ 此处确保权限已就绪，可安全访问存储
text = f"1{App.get_running_app().user_data_dir}\n"
self.label = Label(text=text, halign="left", valign="top")
self.label.text_size = (self.label.width * 0.9, None)
if platform == "android":
folder_path = Path(primary_external_storage_path(), "my_kivy_app_folder")
try:
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 PermissionError as e:
self.label.text += f"❌ 权限被拒绝: {e}\n"
except Exception as e:
self.label.text += f"⚠️ 写入异常: {e}\n"
else:
file_path = Path.home() / "test_kivy.txt"
with open(file_path, "w", encoding="utf-8") as f:
f.write("Hello from desktop!\n")
self.label.text += f"✅ 已写入: {file_path}\n"
return self.label
def _check_storage_permissions(self):
"""检查是否已拥有读写外部存储权限"""
return (
check_permission(Permission.READ_EXTERNAL_STORAGE) and
check_permission(Permission.WRITE_EXTERNAL_STORAGE)
)
# === 主入口：权限请求前置 ===
if __name__ == '__main__':
if platform == "android":
# ? 关键：在 App.run() 前请求权限
def on_permissions_granted(permissions, grant_results):
# grant_results 是布尔列表，对应 permissions 的授权状态
if all(grant_results):
print("✅ 所有存储权限已授予")
MyApp().run()
else:
print("❌ 用户拒绝了部分权限，应用将无法访问外部存储")
# 发起请求（注意：此调用会触发系统弹窗）
request_permissions(
[Permission.READ_EXTERNAL_STORAGE, Permission.WRITE_EXTERNAL_STORAGE],
on_permissions_granted
)
else:
MyApp().run()⚠️ 重要注意事项
- Android 10+（API 29）及更高版本限制：从 Android 10 开始，WRITE_EXTERNAL_STORAGE 对应用私有目录外的路径不再提供宽泛写入能力（Scoped Storage）。如需访问公共目录（如 DCIM/, Downloads/），应改用 MediaStore API 或申请 MANAGE_EXTERNAL_STORAGE（需 Google Play 审核批准）。对于应用专属文件，推荐优先使用 app_storage_path() 或 get_files_dir()（通过 android.storage 或 jnius 获取），无需额外权限。
-
buildozer.spec 配置需匹配：确保 android.permissions 包含对应权限（注意大小写和命名空间）：
android.permissions = READ_EXTERNAL_STORAGE, WRITE_EXTERNAL_STORAGE
- 不要忽略回调：永远不要假设 request_permissions() 同步成功；务必通过回调函数判断授权结果。
- 测试建议：在真机上测试，模拟器可能权限行为不一致；首次安装后手动进入「设置 → 应用 → 权限」验证状态。
✅ 总结
解决 Kivy Android 存储权限问题的核心在于：声明 + 运行时请求 + 回调驱动 + 时机前置。将权限请求移至 App.run() 之前，并严格依据授权结果决定后续流程，即可彻底规避 PermissionError。同时，关注 Android 版本演进对存储模型的影响，合理选择存储路径策略，是构建健壮跨平台移动应用的关键一步。
