Docker执行Streamlit容器卡在欢迎提示无法启动的问题咨询

启动卡住的核心原因是Streamlit首次运行默认会弹出交互式欢迎引导，询问用户邮箱、是否同意收集使用统计，Docker容器默认启动是无交互环境，无法响应输入就会直接挂起。

修改Dockerfile加入对应配置跳过引导即可，两种方案选任意一种都能解决问题：

• 方案一：添加全局环境变量（推荐，后续修改启动脚本也不会失效）
  在Dockerfile的EXPOSE 8501行之前插入两行环境变量配置：

# 关闭使用统计收集，跳过首次运行交互提示
ENV STREAMLIT_BROWSER_GATHER_USAGE_STATS=false
ENV STREAMLIT_SERVER_HEADLESS=true

原有ENTRYPOINT、CMD配置不需要改动，重新构建镜像后启动就会直接运行app.py，不会再弹出邮箱输入提示。

• 方案二：直接给启动命令传参
  把Dockerfile末尾的启动配置替换为如下内容，直接在streamlit run命令后传入无头模式、关闭统计的参数：

# Execution
ENTRYPOINT [ "streamlit", "run" ]
CMD ["app.py", "--server.headless=true", "--browser.gatherUsageStats=false"]

注意：不要用管道传回车、启动时手动输回车这类临时方案，容器重建、迁移到其他环境运行时还会复现卡住问题，配置层面关闭引导是永久生效的解决方式。

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