Streamlit集成Keycloak首次返回空Token问题求助

确实是异步机制导致的。streamlit_keycloak的login函数基于Keycloak JavaScript适配器实现认证，整个认证流程是异步完成的。而Streamlit的脚本是同步从上到下执行的：第一次运行脚本时，异步认证流程还未结束，因此返回的是未认证的空Token状态；当异步认证完成后，库会自动触发Streamlit页面重渲染，此时第二次执行脚本就能拿到完整的已认证Token状态。这就导致页面先短暂显示"Not authenticated"，随后刷新显示"Authenticated"。

方法1：用Session State保存实例+加载状态提示 #

将Keycloak实例存入Streamlit的Session State避免重复初始化，同时在认证流程未完成时显示加载提示，而非直接输出未认证文本：

import streamlit as st
from streamlit_keycloak import login
import config

# 初始化Session State中的Keycloak实例，避免每次重渲染重复创建
if "keycloak_instance" not in st.session_state:
    st.session_state.keycloak_instance = login(
        url=config.URL,
        realm=config.REALM,
        client_id=config.CLIENT_ID,
        init_options={
            "checkLoginIframe": False
        }
    )

keycloak = st.session_state.keycloak_instance

# 根据认证状态渲染内容
if keycloak.authenticated:
    st.write("Authenticated")
else:
    # 认证流程进行中时显示加载提示，等待自动重渲染
    with st.spinner("正在验证身份，请稍候..."):
        pass

方法2：强制重渲染等待认证完成 #

通过标记避免无限循环，在认证状态未就绪时触发重渲染，确保拿到最终认证状态后再渲染页面：

import streamlit as st
from streamlit_keycloak import login
import config

# 初始化Session State中的Keycloak实例
if "keycloak_instance" not in st.session_state:
    st.session_state.keycloak_instance = login(
        url=config.URL,
        realm=config.REALM,
        client_id=config.CLIENT_ID,
        init_options={
            "checkLoginIframe": False
        }
    )

keycloak = st.session_state.keycloak_instance

# 未认证且未触发过重渲染时，强制重渲染等待认证结果
if not keycloak.authenticated and "rerun_triggered" not in st.session_state:
    st.session_state.rerun_triggered = True
    st.experimental_rerun()

# 渲染最终状态
if keycloak.authenticated:
    st.write("Authenticated")
else:
    st.write("Not authenticated")

说明 #

• 方法1更友好，用户不会看到未认证的闪烁文本，只会在认证过程中看到加载提示；
• 方法2通过强制重渲染跳过初始的未认证状态，直接等待拿到最终结果后再显示内容，适合需要严格控制页面显示逻辑的场景。

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