Kivy中播放GIF时出现白屏及程序无响应问题求助

我看了你的代码，发现几个核心问题导致了窗口白屏、后续无响应的情况，咱们一步步来修复：

1. 错误返回Widget类而非实例 #

你的Builder.load_string只是定义了<GIF>这个自定义布局的规则，但build方法直接返回了这个类定义，而不是它的实例。Kivy需要渲染的是Widget实例，这直接导致初始窗口没有内容，显示全白。

2. 后台函数阻塞主线程 #

你用Clock.schedule_once调用了m.Running_in_background，如果这个函数是同步阻塞操作（比如长时间计算、等待外部资源），会完全卡住Kivy的主线程——Kivy的UI更新、事件循环都依赖主线程，一旦被阻塞，窗口必然会无响应。

3. 窗口属性操作时机不当 #

你在全局作用域修改Window的大小、位置等属性，时机太早，可能和App初始化流程冲突，导致窗口渲染异常。

修正后的完整代码 #

import kivy
from kivy.clock import Clock
from functools import partial
import main as m
kivy.require("1.10.0")
from kivy.lang.builder import Builder
from kivy.app import App
from kivy.uix.anchorlayout import AnchorLayout
from kivy.core.window import Window

# 单独定义KV字符串，结构更清晰
KV = """
<GIF>:
    Image:
        id: img_gif
        source: '1.gif'
        anim_loop: 0  # 0表示无限循环播放
"""
Builder.load_string(KV)

# 明确创建GIF布局类，对应KV中的定义
class GIF(AnchorLayout):
    pass

class SampleApp(App):
    def build(self):
        # 把窗口属性设置移到build方法中，确保和UI初始化同步
        Window.size = (300, 100)
        Window.borderless = True
        Window.left = 1620
        Window.top = 140
        # 返回GIF布局的实例，而非类定义
        return GIF()
    
    def on_start(self):
        # 延迟到UI初始化完成后，再调度后台任务
        Clock.schedule_once(partial(self.run_background_safely, Window.show), 0.1)
    
    def run_background_safely(self, show_func, dt):
        # 用线程执行后台阻塞操作，避免卡住UI主线程
        import threading
        # 设置daemon=True，让线程随主程序自动退出
        threading.Thread(target=m.Running_in_background, args=(show_func,), daemon=True).start()

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

额外检查要点 #

• 确认1.gif文件路径正确：要么和脚本在同一目录，要么使用绝对路径，路径错误会导致Image加载失败，依然显示空白。
• 考虑升级Kivy版本：1.10.0是比较老的版本，后续版本修复了不少GIF播放相关的bug，升级到稳定版（比如2.2.0）可能解决潜在问题。
• 检查main.py中的Running_in_background函数：确保没有未捕获的异常，异常也可能导致程序无响应。

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