Kivy弹窗报错：Popup can have only one widget as content 解决咨询

错误原因 #

你遇到的kivy.uix.popup.PopupException: Popup can have only one widget as content异常，本质是Kivy的Popup组件要求content属性必须是单个Widget，不能直接传入多个控件。所有弹窗内的UI元素需要先放入一个容器控件（如BoxLayout、GridLayout），再将这个容器作为content赋值给Popup。

基于你的三文件架构的修改方案 #

保持main.py（入口）、my.kv（布局）、mygrid.py（自定义Grid组件）的原有架构不变，以下是具体修改：

1. 修改mygrid.py中的弹窗创建逻辑

在自定义Grid类里添加弹窗触发函数，确保弹窗内容被容器包裹：

from kivy.uix.gridlayout import GridLayout
from kivy.uix.popup import Popup
from kivy.uix.boxlayout import BoxLayout
from kivy.uix.label import Label
from kivy.uix.button import Button

class MyGrid(GridLayout):
    def show_popup(self):
        # 创建弹窗内容的容器（用BoxLayout垂直排列元素）
        popup_content = BoxLayout(orientation='vertical', padding=15, spacing=10)
        
        # 向容器添加弹窗需要的控件
        popup_content.add_widget(Label(text="这是弹窗的内容"))
        close_btn = Button(text="关闭弹窗", size_hint_y=None, height=45)
        close_btn.bind(on_press=lambda _: popup.dismiss())
        popup_content.add_widget(close_btn)
        
        # 创建Popup，将容器作为content传入
        popup = Popup(
            title="示例弹窗",
            content=popup_content,
            size_hint=(0.7, 0.4)  # 控制弹窗相对窗口的大小
        )
        popup.open()

2. 在my.kv中绑定弹窗触发按钮

确保布局文件里的按钮正确调用show_popup方法：

<MyGrid>:
    cols: 1
    Button:
        text: "点击打开弹窗"
        size_hint: (1, 0.1)
        on_press: root.show_popup()

3. main.py保持原有入口逻辑不变

from kivy.app import App
from mygrid import MyGrid

class MyApp(App):
    def build(self):
        return MyGrid()

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

另一种KV定义弹窗的方式（可选） #

如果习惯用KV语言定义弹窗结构，也可以在my.kv中自定义Popup组件，同样不改变文件架构：

<MyCustomPopup@Popup>:
    size_hint: 0.7, 0.4
    title: "自定义弹窗"
    BoxLayout:
        orientation: 'vertical'
        padding: 15
        spacing: 10
        Label:
            text: "KV定义的弹窗内容"
        Button:
            text: "关闭"
            size_hint_y: None
            height: 45
            on_press: root.dismiss()

然后在mygrid.py的show_popup方法中直接实例化这个自定义Popup：

from kivy.factory import Factory

class MyGrid(GridLayout):
    def show_popup(self):
        popup = Factory.MyCustomPopup()
        popup.open()

内容的提问来源于stack exchange，提问作者Genaro.exe