在MS Teams运行Streamlit AI聊天机器人出现橙色警告及appInitTimeout错误

• 调整Teams SDK初始化时机
  Streamlit的页面渲染是异步的，默认的SDK初始化代码可能在页面元素未完全就绪时执行，触发超时错误。修改初始化逻辑，确保在Streamlit页面完全加载后再初始化Teams SDK，同时主动通知Teams初始化完成：

  function initTeamsSDK() {
    microsoftTeams.initialize();
    // 可选：适配Teams主题，避免样式冲突
    microsoftTeams.registerOnThemeChangeHandler(theme => {
      document.body.style.backgroundColor = theme === 'dark' ? '#1e1e1e' : '#ffffff';
    });
    // 关键：通知Teams应用已加载完成
    microsoftTeams.notifyAppLoaded();
    microsoftTeams.notifySuccess();
  }
  
  // 监听Streamlit专属加载完成事件
  document.addEventListener('streamlit:loaded', initTeamsSDK);
  // 降级处理：如果上述事件未触发，延迟3秒执行初始化
  setTimeout(initTeamsSDK, 3000);
  

• 优化Streamlit应用加载性能
  Azure VM的网络延迟可能导致Teams侧检测超时，可通过以下方式优化：

  • 在config.toml中启用客户端缓存并调整服务器设置：

    [server]
    enableCORS = false
    enableXsrfProtection = false
    cache_size = "200MB"
    maxUploadSize = "100MB"
    

  • 启动应用时开启静态资源服务：streamlit run your_app.py --server.enableStaticServing true
  • 简化初始页面组件，优先渲染聊天核心界面，非必要模块延迟加载

• 调整Teams应用清单的超时配置
  在Teams应用的manifest.json中增加超时时间参数，避免Teams过早判定初始化失败：

  {
    "$schema": "https://developer.microsoft.com/en-us/json-schemas/teams/v1.16/MicrosoftTeams.schema.json",
    "version": "1.0.0",
    "manifestVersion": "1.16",
    "id": "<你的应用ID>",
    "name": "<应用名称>",
    // 其他配置...
    "timeoutIntervalInSeconds": 30,
    "validDomains": ["<你的企业域名>"]
  }
  

• 验证SSL证书与域名的兼容性
  确保企业域名的SSL证书由Teams信任的根CA签发，避免证书验证延迟：

  • 用OpenSSL检查证书链完整性：openssl s_client -connect your-domain.com:443
  • 确认域名在Teams客户端网络环境中可正常解析，排除DNS延迟问题

• 隐藏Streamlit默认UI元素（可选）
  Streamlit自带的头部、侧边栏可能干扰Teams容器的检测逻辑，在Python代码中添加隐藏样式：

  import streamlit as st
  
  st.set_page_config(page_title="AI聊天机器人", page_icon="🤖", layout="wide")
  # 隐藏Streamlit默认UI组件
  hide_default_ui = """
  <style>
  #MainMenu {visibility: hidden;}
  footer {visibility: hidden;}
  header {visibility: hidden;}
  </style>
  """
  st.markdown(hide_default_ui, unsafe_allow_html=True)
  

内容的提问来源于stack exchange，提问作者워니혀니