KivyMD安卓应用读取Excel文件时遭遇权限错误

• 环境：KivyMD 2.3.0(dev) + Buildozer构建的安卓平板应用
• 核心问题：
  • 可正常读取、列出图片类文件（.jpeg/.png），但MDFileManager无法显示.xlsx文件
  • 直接通过代码路径打开.xlsx文件时触发权限错误，日志如下：

PermissionError: [Errno 13] Permission denied: '/storage/emulated/0/Documents/template2.xlsx'

• 已执行的排查操作：
  1. 在buildozer.spec中配置了READ_EXTERNAL_STORAGE、WRITE_EXTERNAL_STORAGE权限
  2. 通过chmod a+xwr 'template2.xlsx'修改目标文件权限
  3. 平板端已手动授予应用文件访问权限
  4. 代码中添加了运行时权限请求逻辑

当前buildozer.spec权限配置：

#(list) Permissions
android.permissions = android.permission.INTERNET, android.permission.WRITE_EXTERNAL_STORAGE, android.permission.READ_EXTERNAL_STORAGE

1. 适配Android 10+分区存储机制 #

Android 10及以上启用了分区存储，传统存储权限无法完全访问公共目录，需在buildozer.spec中添加以下配置：

# 强制使用旧版存储访问模式
android.requestLegacyExternalStorage = True
# 补充MANAGE_EXTERNAL_STORAGE权限（针对Android 11+）
android.permissions = android.permission.INTERNET, android.permission.WRITE_EXTERNAL_STORAGE, android.permission.READ_EXTERNAL_STORAGE, android.permission.MANAGE_EXTERNAL_STORAGE

2. 配置MDFileManager显示.xlsx文件 #

MDFileManager默认仅过滤显示媒体类文件，需手动指定允许显示的文件后缀：

# 修改MDFileManager初始化代码
self.file_manager = MDFileManager(
    exit_manager=self.exit_manager,
    select_path=self.select_path,
    extensions=['.xlsx', '.png', '.jpeg']  # 包含需要显示的文件类型
)

3. 延迟.xlsx文件读取到应用生命周期后期 #

当前代码在模块加载阶段直接打开.xlsx文件，此时应用可能尚未完成权限初始化，导致权限错误。将文件读取逻辑移至build方法：

# 移除模块顶部的直接读取代码：
# workbook = openpyxl.open('/storage/emulated/0/Documents/template2.xlsx')
# ws = workbook.active

class Example(MDApp):
    def __init__(self):
        super().__init__()
        self.manager_open = False
        self.file_manager = MDFileManager(
            exit_manager=self.exit_manager,
            select_path=self.select_path,
            extensions=['.xlsx', '.png', '.jpeg']
        )
        self.workbook = None
        self.ws = None

    def build(self):
        self.theme_cls.primary_palette = "Green"
        # 延迟初始化工作簿，确保权限已生效
        try:
            self.workbook = openpyxl.open('/storage/emulated/0/Documents/template2.xlsx')
            self.ws = self.workbook.active
        except PermissionError:
            # 可添加权限提示或错误处理逻辑
            pass
        return Builder.load_string(KV)

4. 修正临时文件存储路径 #

代码中直接保存img.png到当前目录，安卓环境下该目录可能无写入权限，需改为应用合法存储路径：

from kivy.utils import platform
import os

def select_path(self, path: str):
    # 获取应用可写入的临时目录
    if platform == 'android':
        from android.storage import app_storage_path
        temp_dir = app_storage_path()
    else:
        temp_dir = os.getcwd()
    img_path = os.path.join(temp_dir, "img.png")

    with PILImage.open(path) as img:
        img = img.resize((150, 100), PILImage.LANCZOS)
        img.save(img_path)
    img = ExcelImage(img_path)
    self.ws.add_image(img, "B2")
    self.ws["A1"] = "Hola Mundo"
    self.exit_manager()
    self.workbook.save('/storage/emulated/0/Documents/output.xlsx')

5. 确保主动请求运行时权限 #

即使在buildozer.spec中声明权限，仍需在代码中主动请求：

from android.permissions import request_permissions, Permission

class Example(MDApp):
    def build(self):
        # 主动请求存储权限
        request_permissions([Permission.READ_EXTERNAL_STORAGE, Permission.WRITE_EXTERNAL_STORAGE])
        self.theme_cls.primary_palette = "Green"
        # 后续初始化逻辑...

内容的提问来源于stack exchange，提问作者Charly_Z