如何在Streamlit中使用file_uploader后自动跳转至指定页面？

问题原因 #

你遇到的Calling st.rerun() within a callback is a no-op错误，是因为st.switch_page内部会触发st.rerun，而Streamlit不允许在组件的回调函数（比如on_change绑定的函数）中调用st.rerun，直接在file_uploader的回调里用switch_page就会触发该报错。

可行实现方案 #

不需要依赖on_change回调，直接在主页面的执行流程中检测文件上传状态，结合session_state存储文件并触发跳转：

首页代码（比如Home.py）

import streamlit as st

# 初始化会话状态，用于跨页面共享文件
if "uploaded_file" not in st.session_state:
    st.session_state.uploaded_file = None

# 文件上传组件
uploaded_file = st.file_uploader("Choose a file", type=['xlsx'])

# 检测到文件上传后，存入会话状态并跳转
if uploaded_file is not None:
    st.session_state.uploaded_file = uploaded_file
    st.switch_page("pages/1_Process.py")

数据处理页代码（pages/1_Process.py）

import streamlit as st

# 校验是否有上传的文件
if "uploaded_file" not in st.session_state or st.session_state.uploaded_file is None:
    st.error("请先上传文件再进入处理页")
    st.page_link("Home.py", label="返回首页上传文件")
else:
    # 获取上传的文件并执行处理逻辑
    target_file = st.session_state.uploaded_file
    st.success(f"已获取文件：{target_file.name}，开始处理...")
    
    # 这里添加你的数据处理代码
    # 示例：读取Excel文件
    import pandas as pd
    df = pd.read_excel(target_file)
    st.dataframe(df.head())

关键说明 #

• 利用st.session_state跨页面共享上传的文件，避免页面跳转后数据丢失
• 在主页面的正常执行流程中判断文件状态并跳转，避开回调函数的限制
• 处理页要先校验会话状态中的文件是否存在，防止用户直接访问处理页导致异常

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