Kivy报错AttributeError: CardFinder对象无textbox_franchise属性求解

问题根因 #

这个AttributeError本质是CardFinder类实例在执行find_prize回调时，实例属性字典里找不到textbox_franchise，纯Python编写Kivy UI时这个报错90%以上是以下三个原因导致的，按出现概率排序：

常见踩坑与修复方案 #

1. 输入框控件没绑定到实例，只定义成了局部变量

写UI构建代码时如果直接写textbox_franchise = TextInput(...)，这个变量只是__init__方法内的局部变量，方法执行完就会被回收，回调里通过self.textbox_franchise访问必然报错。

错误写法：

def __init__(self, **kwargs):
    super().__init__(**kwargs)
    # 局部变量，实例无法访问
    textbox_franchise = TextInput(hint_text="输入卡牌所属系列")
    self.add_widget(textbox_franchise)

    continue_btn = Button(text="Continue")
    continue_btn.bind(on_press=self.find_prize)
    self.add_widget(continue_btn)

修复：给控件名加self.前缀，挂载到类实例上：

self.textbox_franchise = TextInput(hint_text="输入卡牌所属系列")
self.add_widget(self.textbox_franchise)

2. 控件创建顺序错误，绑定回调时属性还没定义

如果先写了按钮绑定回调的逻辑，后面才初始化self.textbox_franchise，只要回调触发时属性还没赋值，就会抛错。

错误写法：

def __init__(self, **kwargs):
    super().__init__(**kwargs)
    # 先绑回调，此时实例上还没有textbox_franchise
    continue_btn = Button(text="Continue")
    continue_btn.bind(on_press=self.find_prize)
    self.add_widget(continue_btn)

    # 后创建输入框属性
    self.textbox_franchise = TextInput()
    self.add_widget(self.textbox_franchise)

修复：统一把所有回调中要访问的控件，放在UI构建逻辑的最前面初始化，先赋值到self，再做事件绑定、添加其他控件的操作。

3. 属性名拼写不一致

定义属性和回调里访问属性时的拼写有偏差，比如多写/漏写字母、下划线位置错，比如定义时写的是self.textbox_franchis少了最后一个e，回调里写self.textbox_franchise就会找不到。全局搜索textbox_franchise关键词，核对所有出现位置的拼写完全一致即可。

可运行参考代码 #

from kivy.app import App
from kivy.uix.boxlayout import BoxLayout
from kivy.uix.textinput import TextInput
from kivy.uix.button import Button
from selenium import webdriver
# 其他selenium依赖自行导入

class CardFinder(BoxLayout):
    def __init__(self, **kwargs):
        super().__init__(orientation="vertical", padding=20, spacing=15, **kwargs)
        # 先初始化所有回调要用到的控件
        self.textbox_franchise = TextInput(hint_text="卡牌系列", size_hint=(1, 0.15))
        self.textbox_card_name = TextInput(hint_text="卡牌名称", size_hint=(1, 0.15))
        self.condition_input = TextInput(hint_text="卡牌品相（全新/二手等）", size_hint=(1, 0.15))
        
        # 再初始化按钮绑定事件
        self.continue_btn = Button(text="Continue", size_hint=(1, 0.15))
        self.continue_btn.bind(on_press=self.find_prize)
        
        # 最后把控件添加到布局
        self.add_widget(self.textbox_franchise)
        self.add_widget(self.textbox_card_name)
        self.add_widget(self.condition_input)
        self.add_widget(self.continue_btn)

    def find_prize(self, instance):
        # 这里可以正常获取所有输入框内容
        franchise = self.textbox_franchise.text.strip()
        card_name = self.textbox_card_name.text.strip()
        condition = self.condition_input.text.strip()
        
        # 后续写selenium访问cardmarket查询的逻辑即可
        # driver = webdriver.Chrome()
        # ... 爬取逻辑

class CardPriceCalcApp(App):
    def build(self):
        return CardFinder()

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

快速排查技巧 #

如果还是找不到问题，在find_prize方法第一行加print([attr for attr in dir(self) if 'textbox' in attr])，点击按钮时看控制台打印的textbox相关属性名，就能直接知道实例上实际的属性名是什么，对照修正即可。

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