Streamlit多页应用切换页面时会话状态重置问题求助

核心问题原因 #

你的主页面mainpage.py中初始化st.session_state的逻辑存在问题：每次切回主页面时，代码会直接覆盖会话状态中的值，而不是仅在首次加载时初始化。

具体解决方法 #

1. 仅在首次加载时初始化会话状态 #

将原来的直接赋值逻辑，改为先判断状态是否存在，再初始化。这样就不会在页面重复加载时重置已有值。

错误写法（会导致重置）：

# 每次加载主页面都会覆盖原有值
st.session_state.multi_select = ["选项1"]
st.session_state.select_slider = 50
st.session_state.text_inp = "默认文本"

正确写法（仅首次初始化）：

可以用if not in判断：

# 仅当状态不存在时才初始化
if "multi_select" not in st.session_state:
    st.session_state.multi_select = ["选项1"]
if "select_slider" not in st.session_state:
    st.session_state.select_slider = 50
if "text_inp" not in st.session_state:
    st.session_state.text_inp = "默认文本"

也可以用更简洁的setdefault方法：

# 若键不存在则设置默认值，存在则保留原值
st.session_state.setdefault("multi_select", ["选项1"])
st.session_state.setdefault("select_slider", 50)
st.session_state.setdefault("text_inp", "默认文本")

2. 正确绑定控件与会话状态 #

创建控件时，通过key参数直接关联会话状态的键，Streamlit会自动同步控件值和会话状态，无需手动赋值：

# 多选框
st.multiselect("选择选项", ["选项1", "选项2", "选项3"], key="multi_select")

# 滑块
st.select_slider("选择数值", options=range(0, 101), key="select_slider")

# 文本输入框
st.text_input("输入文本", key="text_inp")

这样修改控件值后，st.session_state中对应的键会自动更新；切回主页面时，控件会直接读取会话状态中的已有值展示。

3. 验证效果 #

修改代码后按以下流程测试：

• 在主页面修改控件值
• 切换到anotherpage.py
• 切回主页面，此时控件应保留修改后的值，不会重置为初始状态

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