未容器化的Streamlit应用部署至Azure App Service时出现容器错误

1. 配置启动命令 #

Azure Web App默认的容器启动逻辑不匹配Streamlit的运行要求，必须手动指定启动命令：

• 打开Azure Portal的Web App实例，左侧菜单选「配置」→「常规设置」
• 在「启动命令」栏填入：
  streamlit run your_app.py --server.port 8000 --server.address 0.0.0.0
  把your_app.py替换成你的主应用文件名，端口必须用8000或80（Azure Web App默认对外映射端口），地址设为0.0.0.0允许容器内部访问

2. 对齐Python版本 #

• 检查本地开发的Python版本，和Web App配置的版本保持一致：进入「配置」→「常规设置」→「Python版本」，选择对应大版本（比如3.9/3.10）
• 确保requirements.txt里的依赖包版本兼容所选Python版本

3. 设置关键环境变量 #

• 进入「配置」→「应用设置」，添加以下键值对：
  • WEBSITE_WEBDEPLOY_USE_SCM → true
  • PYTHONPATH → 对应系统路径：Windows环境填D:\home\site\wwwroot，Linux环境填/home/site/wwwroot
    这两个设置能避免部署时的容器路径匹配错误

4. 验证部署文件结构 #

如果用本地Git/Zip部署：

• 确保部署的根目录直接包含requirements.txt和主应用文件，不要嵌套多余文件夹
• 部署完成后，进入Web App的「高级工具」→「Kudu控制台」，检查site/wwwroot下的文件结构是否正确，确认项目文件都已上传

5. 查看日志定位具体问题 #

如果以上步骤无效，直接看容器日志找根源：

• 进入Web App的「日志」→「容器日志」，里面会显示容器启动失败的具体原因（比如依赖缺失、端口冲突、启动命令错误）
• 也可以在Kudu控制台的LogFiles目录下查看更详细的运行日志

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