Docker部署Apache Superset报表执行报list index out of range错误如何解决

错误诱发原因 #

1. superset_config.py配置未生效：你的Dockerfile中RUN export PYTHONPATH=/usr/src/app/superset_config.py写法错误，PYTHONPATH需要指向配置文件所在的目录而非文件本身，且RUN指令执行的export仅在构建层生效，容器运行时不会保留该环境变量，导致你编写的SMTP配置、报表调度参数完全没有被Superset加载。
2. 缺失报表邮件必要配置：未开启报表调度功能开关、未正确配置SMTP邮件参数、未配置合法的发件人/收件人地址时，系统在组装邮件内容时读取空列表就会触发list index out of range报错。
3. 无头浏览器参数不完整：部分版本Superset生成报表时需要显式指定Chrome无头启动参数，否则虽然能生成缓存缩略图，但后续生成邮件附件时读取不到合法的截图对象，也会触发列表越界。
4. 服务间访问地址配置错误：日志中截图使用的域名http://superset.com如果没有在worker容器中配置hosts，会导致worker无法正常读取截图文件用于邮件组装。

修复方案 #

步骤1：修正Dockerfile的环境变量配置 #

将Dockerfile末尾的RUN export PYTHONPATH=/usr/src/app/superset_config.py替换为以下内容，保证配置文件全局生效：

ENV PYTHONPATH="/usr/src/app:${PYTHONPATH}"

步骤2：补全superset_config.py配置 #

在你的superset_config.py中添加以下配置，替换为实际的SMTP参数：

# 开启告警报表功能
FEATURE_FLAGS = {
    "ALERT_REPORTS": True,
    "THUMBNAILS": True,
}

# 无头浏览器配置
WEBDRIVER_TYPE = "chrome"
WEBDRIVER_OPTION_ARGS = [
    "--headless",
    "--disable-gpu",
    "--no-sandbox",
    "--disable-dev-shm-usage",
]
# 直接使用docker-compose内部服务名访问，避免域名解析问题
WEBDRIVER_BASEURL = "http://superset:8080/"

# SMTP邮件配置
SMTP_HOST = "你的SMTP服务地址，例如smtp.qq.com"
SMTP_PORT = 你的SMTP端口，例如465
SMTP_USERNAME = "发件人邮箱账号"
SMTP_PASSWORD = "发件人邮箱授权码"
SMTP_USE_TLS = False
# 端口为465则开启SSL，端口为587则开启TLS
SMTP_USE_SSL = True
SMTP_MAIL_FROM = "发件人邮箱地址，和SMTP_USERNAME保持一致"

步骤3：重新构建镜像并重启服务 #

依次执行以下命令完成部署更新：

# 停止原有服务并清除缓存卷
docker-compose down -v
# 重新构建superset镜像
docker build -t superset .
# 启动所有服务
docker-compose up -d

步骤4：验证报表任务配置 #

登录Superset后台检查对应的报表任务，确认收件人列表已填写至少一个合法邮箱地址，无空配置项。

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