Kivy ScrollView直接点击滚动条触发IndexError异常问题求助

问题原因 #

这是Kivy旧版本（2.1.0版本以前）的原生框架Bug，并非配置遗漏导致。
触发逻辑为：

• ScrollEffect类的history列表需要在on_scroll_start事件中完成初始化
• 当用户首次交互直接点击滚动条时，旧版本的事件分发逻辑会跳过on_scroll_start的部分初始化逻辑，直接进入on_scroll_move阶段
• 此时调用effect_x.update/effect_y.update方法时，history列表为空，访问history[-1]就会抛出IndexError异常
• 先点击内容区域再操作滚动条不会出错，是因为点击内容的交互会正常触发history列表的初始化流程

修复方案 #

方案1：升级Kivy版本（最推荐） #

该Bug已经在Kivy 2.1.0及以上正式版本中被官方修复，直接升级框架即可解决问题：

pip install --upgrade kivy

方案2：兼容旧版本自定义修复 #

如果项目受依赖限制无法升级Kivy版本，可以通过自定义ScrollView子类，手动补全初始化逻辑规避问题：

from kivy.app import App
from kivy.uix.image import Image
from kivy.uix.scrollview import ScrollView
from kivy.core.window import Window
from kivy.effects.scroll import ScrollEffect

class FixedScrollView(ScrollView):
    def on_scroll_start(self, touch, check_children=True):
        # 手动初始化滚动效果的history列表
        for effect in (self.effect_x, self.effect_y):
            if isinstance(effect, ScrollEffect) and not getattr(effect, 'history', []):
                effect.history = []
        return super().on_scroll_start(touch, check_children)

class TutorialApp(App):
    def build(self):
        some_img = Image(source='/home/data/map/Map_07C.jpg', size_hint=(None, None),
                         keep_ratio=True, size=(Window.width * 2, Window.height * 2))
        sv = FixedScrollView(size=Window.size, bar_width=50,
                        scroll_type=['bars', 'content'], effect_cls='ScrollEffect')
        sv.add_widget(some_img)
        return sv

if __name__ == "__main__":
    TutorialApp().run()

临时规避方案 #

如果不想修改代码，可以在首次操作滚动条前先点击一次滚动内容区域，即可正常使用滚动条功能。

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