Azure App Service部署Python Dash应用时Kaleido版本适配与静态图像渲染报错问题求助

我来帮你梳理下这个问题的根源，然后给出几个实用的解决办法，帮你顺利在Azure App Service上用上Kaleido做静态图像渲染：

首先明确核心问题：你本地能用kaleido==0.1.0.post1，但Azure上找不到这个版本，是因为该版本没有适配Python 3.12的二进制包（wheel），而pip 24.2对版本兼容性的检查更严格，所以无法匹配到合适的分发版本。下面针对你尝试过的各个版本的问题，逐一给出解决方案：

一、解决kaleido 0.2.0/0.2.1的挂起问题 #

你提到这两个版本会导致应用挂起，大概率是Linux环境下的依赖或进程启动限制问题，可以试试这几个调整：

• 在requirements.txt中保留kaleido==0.2.1（0.2.1比0.2.0更稳定）
• 在应用代码开头添加环境变量配置，绕过部分Web安全限制：

  import os
  os.environ["KALEIDO_SKIP_WEBSECURITY"] = "1"
  

• 检查Azure App Service的实例规格，建议至少使用B1及以上的实例，避免内存不足导致进程挂起

二、修复kaleido 0.1.0的可执行文件缺失问题 #

如果偏好0.1.x版本，可以手动在部署流程中添加二进制文件：

1. 先从Kaleido官方发布渠道下载适配Linux系统的0.1.0版本二进制压缩包，将其放到项目根目录
2. 修改你的build&deploy.yml，在ArchiveArtifact阶段的脚本中加入解压步骤：

   # 创建对应目录并解压kaleido二进制文件
   mkdir -p ./kaleido/executable
   tar -xzf kaleido_linux.tar.gz -C ./kaleido/executable/
   

3. 在应用代码中指定可执行文件路径：

   import os
   os.environ["KALEIDO_PATH"] = os.path.join(os.getcwd(), "kaleido/executable/kaleido")
   

三、解决kaleido 1.0.0rc0的Chrome依赖问题 #

kaleido 1.x版本不再内置Chrome/Chromium，需要系统单独安装，针对Azure App Service Linux（Ubuntu镜像），有两种实现方式：

方式1：通过启动命令安装Chrome #

在Azure门户的App Service配置中，找到「启动命令」，替换为以下内容（注意把app:server换成你实际的Dash应用入口，比如your_main_file:app）：

apt-get update && apt-get install -y chromium-browser && gunicorn --bind=0.0.0.0 --timeout 600 app:server

然后在应用代码中指定Chrome路径：

import os
os.environ["BROWSER_PATH"] = "/usr/bin/chromium-browser"

方式2：在部署Pipeline中安装Chrome #

修改build&deploy.yml的DeployDev阶段，添加安装Chrome的步骤：

- script: |
    sudo apt-get update
    sudo apt-get install -y chromium-browser
  displayName: 'Install Chromium Browser for Kaleido'

同样在应用代码中设置BROWSER_PATH环境变量即可。

额外调试建议 #

• 查看Azure App Service的「日志流」，可以获取更详细的报错堆栈，帮助定位挂起或崩溃的具体原因
• 先在本地用Python 3.12的虚拟环境复现问题，这样能更快调试，减少反复部署到Azure的成本

备注：内容来源于stack exchange，提问作者Jason Susanto