Buildozer构建Android应用后SDL报错：无法加载libpythonXXX.so的解决与诊断

我用Kivy和Buildozer成功构建了一个简易随机数生成APK，安装到Android 5（三星J3）和Android 10设备后，闪屏加载完成就报错：

SDL2 Error: An error occurred while trying to start the application. Please try again and/or reinstall. Error: Could not load any libpythonXXX.so

本地Kivy环境运行正常，使用64位Linux Mate 19.3作为构建环境，试过社区里的方案都没用。附上三个核心文件内容：

1. main.py #

from kivy.app import App
from kivy.uix.boxlayout import BoxLayout
from kivy.uix.label import Label
from kivy.uix.button import Button
import random

class RandomNumberApp(App):
    def build(self):
        layout = BoxLayout(orientation='vertical')
        self.result_label = Label(text="点击按钮生成随机数", font_size=24)
        gen_btn = Button(text="生成随机数", font_size=24)
        gen_btn.bind(on_press=self.generate_random)
        layout.add_widget(self.result_label)
        layout.add_widget(gen_btn)
        return layout

    def generate_random(self, instance):
        self.result_label.text = f"随机数：{random.randint(1, 100)}"

if __name__ == '__main__':
    RandomNumberApp().run()

2. testrandom.kv #

<RandomNumberApp>:
    BoxLayout:
        orientation: 'vertical'
        Label:
            id: result_label
            text: "点击按钮生成随机数"
            font_size: 24
        Button:
            text: "生成随机数"
            font_size: 24
            on_press: app.generate_random()

3. buildozer.spec（关键配置片段） #

[app]
title = RandomNumberApp
package.name = testrandom
package.domain = org.test
source.dir = .
source.include_exts = py,png,jpg,kv,atlas
version = 0.1

requirements = python3,kivy
orientation = portrait
fullscreen = 0
android.api = 29
android.apptheme = @android:style/Theme.Holo.Light
android.sdk = 24
android.ndk = 25b
android.ndk_api = 21
android.arch = armeabi-v7a
android.buildtools = 30.0.3
android.use_aapt2 = True

咨询问题 #

1. 是否存在简单修复方案？
2. 若问题较为复杂，该如何开展诊断工作？

一、简单修复方案 #

• 匹配Python版本与Android架构：在buildozer.spec中明确指定兼容低版本Android的Python版本，同时锁定架构和NDK版本：

  python.version = 3.8
  android.ndk_api = 21
  android.arch = armeabi-v7a
  

  （Android 5仅支持Python 3.8及以下，三星J3为32位设备，需指定armeabi-v7a架构）
• 清理缓存后重建：执行命令彻底清除旧编译缓存，避免残留文件干扰：

  buildozer android clean
  buildozer android debug deploy run
  

• 锁定Kivy兼容版本：将requirements中的Kivy指定为稳定兼容版本，比如kivy==2.1.0，避免最新版Kivy对旧Android的兼容性问题：

  requirements = python3.8,kivy==2.1.0
  

二、复杂情况的诊断步骤 #

1. 抓取Android系统日志：用adb连接设备，过滤关键日志定位具体错误：

   adb logcat | grep -E "python|SDL|kivy"
   

   重点查看libpythonXXX.so找不到的具体原因，是架构不匹配、文件缺失还是权限限制。
2. 检查APK内部结构：解压APK文件，查看lib/armeabi-v7a/目录下是否存在libpython3.8.so文件。如果缺失，说明Buildozer编译时未正确打包Python库。
3. 验证构建环境依赖：确保Linux环境安装了openjdk-8-jdk（Android编译需Java 8）、git、zip等Buildozer必备依赖，避免高版本Java导致的编译异常。
4. 测试最小可运行项目：创建仅包含基础Kivy启动代码的最小项目，用相同Buildozer配置编译运行。如果能正常启动，说明原项目的代码或资源存在问题；如果仍报错，说明环境或配置存在根本性问题。
5. 降级Buildozer版本：若使用最新版Buildozer，尝试降级到buildozer==1.4.0（稳定版本，对旧Android设备兼容性更好），执行命令安装：

   pip install buildozer==1.4.0
   

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