Streamlit应用启动卡顿停留在‘Please Wait’界面问题排查求助

可能的原因及对应解决方法 #

• 检查端口占用情况
  你指定了端口5677，先确认该端口是否被其他程序占用：

  # Windows系统执行
  netstat -ano | findstr :5677
  # macOS/Linux系统执行
  lsof -i :5677
  

  若端口被占用，要么终止占用该端口的进程，要么修改launch.json中的端口号（比如改为8502这类Streamlit备用端口）。

• 跳过配置直接手动启动测试
  先排除VS Code启动配置的问题，直接在终端手动启动应用：
  进入代码所在目录，执行：

  streamlit run 你的脚本文件名.py --server.port 5677
  

  如果手动启动能正常加载，说明是VS Code的launch配置存在潜在问题，可添加工作目录配置修正：

  {
      "version": "0.2.0",
      "configurations": [
          {
              "name":"Python:Streamlit",
              "type":"python",
              "request": "launch",
              "module": "streamlit",
              "args": [
                  "run",
                  "${file}",
                  "--server.port",
                  "5677"
              ],
              "cwd": "${fileDirname}"
          }
      ]
  }
  

• 清除Streamlit缓存
  缓存异常可能导致加载卡住，执行命令清除缓存：

  streamlit cache clear
  

  清除后重新启动应用。

• 确认Python环境一致性
  检查VS Code使用的Python解释器和安装Streamlit的环境是否一致：

  1. 查看VS Code左下角选中的Python解释器版本
  2. 在终端执行which streamlit（macOS/Linux）或where streamlit（Windows），对比路径对应的Python环境
     若不一致，在VS Code中切换到正确的解释器环境。

• 升级Streamlit版本
  你当前使用的1.12.0版本较旧，部分旧版本存在加载相关bug，升级到稳定版：

  pip install --upgrade streamlit
  

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