Streamlit同函数内第二个file_uploader被第一个覆盖失效问题

同一函数内使用两个st.file_uploader组件时，第一个组件可正常运行，点击对应按钮触发第二个文件上传组件时，组件未正常激活，页面反而重新加载展示第一个文件上传组件，功能不符合预期，复现代码如下：

def apps():
    text = None
    passport = st.file_uploader("Upload Passport", type=["png", "jpg"], key="passport")
    if passport:
        button = st.button("Print")
        if button:
            text = st.write(passport.name)
            if text:
                st.success(text)
                verify_button = st.sidebar.button("Verify Face")
                if verify_button:
                    photo = st.sidebar.file_uploader("UPLOAD PHOTO", type=["png", "jpg"], key="photo")

这个问题是Streamlit的运行机制和代码组件嵌套逻辑错误共同导致的：

1. Streamlit每次收到用户交互事件（比如点击按钮、上传文件）都会从头到尾重新执行整个脚本，重新渲染页面组件
2. 原代码把第二个file_uploader和对应的触发按钮都嵌套在了多层if条件块内部，点击Verify Face按钮触发脚本重跑后，按钮状态会立刻重置为False，深层条件块的判断条件不成立，块内的组件根本不会被渲染
3. 组件定义位置随条件判断动态变化，会导致Streamlit的组件状态映射错位，出现第一个组件覆盖第二个组件位置的异常

• 所有带持久化状态的交互组件（文件上传器、输入框、按钮等）不要嵌套在多层条件判断内部，要保证脚本每次重跑时，框架都能稳定识别到这些组件，才能正常留存组件状态
• 按钮仅用来触发业务处理逻辑，不要把组件的定义代码写在按钮的判断分支里
• 给每个组件设置全局唯一的固定key，避免不同组件的状态冲突
• 侧边栏组件、主区域组件尽量在函数靠前位置统一定义，不要等前置操作完成后再动态渲染深层组件，避免组件树结构频繁变动导致状态错位

import streamlit as st

def apps():
    # 提前定义侧边栏所有组件，保证每次重跑都能稳定渲染
    st.sidebar.subheader("人脸验证区")
    verify_button = st.sidebar.button("Verify Face", key="verify_face_btn")
    photo = st.sidebar.file_uploader("UPLOAD PHOTO", type=["png", "jpg"], key="photo")

    # 主区域组件定义
    passport = st.file_uploader("Upload Passport", type=["png", "jpg"], key="passport")
    if passport:
        print_button = st.button("Print", key="print_btn")
        if print_button:
            st.write(passport.name)
            st.success(f"已成功读取护照文件：{passport.name}")

    # 按钮触发的业务逻辑和组件定义分离
    if verify_button:
        if not passport:
            st.warning("请先上传护照文件")
        elif not photo:
            st.warning("请在侧边栏上传待验证的人脸照片")
        else:
            st.info("文件校验通过，开始执行人脸验证流程")
            # 后续在此处写入人脸比对、验证结果返回的业务逻辑即可

if __name__ == "__main__":
    apps()

• 如果需要做分步引导的交互，不要用嵌套条件的方式控制组件显示隐藏，建议用st.session_state存储当前步骤状态，统一控制组件渲染逻辑
• 哪怕组件分别放在主区域和侧边栏，也不要给不同组件设置重复的key，否则会出现状态覆盖问题

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