Streamlit Secrets缺失password密钥报错，寻求解决方法

以下是针对该报错的排查与修复步骤：

1. 本地secrets.toml格式校验 #

确认项目根目录下.streamlit文件夹中的secrets.toml格式完全正确，需为标准键值对格式，无语法错误：

password = "你的密码内容"

注意事项：

• 避免嵌套引号，比如password = "'你的密码'"会导致读取异常
• 若密码包含#、=等特殊字符，需用单引号包裹：password = 'pass#word=123'

2. Streamlit社区云密钥配置验证 #

在Streamlit云应用设置的Secrets栏目中，确认密钥键名为password，与代码中st.secrets["password"]完全匹配：

• 键名区分大小写，不能写成Password或PASSWORD
• 密钥值不要包含多余空格或换行符，直接填写密码内容即可

3. 代码中添加密钥存在性预校验 #

在密码验证逻辑前添加校验，提前排查密钥是否存在，避免报错中断应用：

import streamlit as st
import hmac

# 预检查secrets是否包含password键
if "password" not in st.secrets:
    st.error("未配置password密钥，请检查secrets.toml或Streamlit云设置")
    st.stop()

def check_password():
    """Returns `True` if the user had the correct password."""

    def password_entered():
        """Checks whether a password entered by the user is correct."""
        if hmac.compare_digest(st.session_state["password"], st.secrets["password"]):
            st.session_state["password_correct"] = True
            del st.session_state["password"]  # Don't store the password.
        else:
            st.session_state["password_correct"] = False

    # Return True if the password is validated.
    if st.session_state.get("password_correct", False):
        return True

    # Show input for password.
    st.text_input(
        "Password", type="password", on_change=password_entered, key="password"
    )
    if "password_correct" in st.session_state:
        st.error("😕 Password incorrect")
    return False


if not check_password():
    st.stop()  # Do not continue if check_password is not True.

4. 本地开发的临时替代方案 #

本地调试时若不想依赖secrets.toml，可改用环境变量临时替代：

import os
import streamlit as st
import hmac

# 优先读取secrets，本地调试用环境变量兜底
PASSWORD = st.secrets.get("password") or os.getenv("STREAMLIT_PASSWORD")
if not PASSWORD:
    st.error("未配置密码")
    st.stop()

def check_password():
    def password_entered():
        if hmac.compare_digest(st.session_state["password"], PASSWORD):
            st.session_state["password_correct"] = True
            del st.session_state["password"]
        else:
            st.session_state["password_correct"] = False

    if st.session_state.get("password_correct", False):
        return True

    st.text_input(
        "Password", type="password", on_change=password_entered, key="password"
    )
    if "password_correct" in st.session_state:
        st.error("😕 Password incorrect")
    return False


if not check_password():
    st.stop()

5. Streamlit云部署后的缓存刷新 #

若已确认云端密钥配置正确仍报错：

• 重启Streamlit云应用（应用页面右上角点击"⋮" → "Restart app"）
• 确认部署的代码分支为最新版本，未部署旧代码

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