Docker部署Apache Superset后无法登录及登录报错问题

问题原因 #

数据库迁移未完整执行，导致Superset依赖的user_attribute等核心表未被创建，手动创建管理员账号时也未触发表结构初始化，从而登录时触发SQL错误。

修复步骤 #

1. 停止当前运行的所有Superset容器

docker compose down

2. 清理旧的数据库和存储卷（新部署无数据时执行）
   如果是全新部署且无需要保留的数据，可清理相关卷避免残留问题：

docker volume rm superset_db superset_home

注意：若需保留已有数据，跳过此步骤，直接执行后续迁移命令。

3. 启动依赖服务并执行数据库迁移
   先启动PostgreSQL和Redis服务，等待服务就绪后执行数据库结构升级：

# 启动依赖服务
docker compose up -d postgres redis
# 等待10-15秒让数据库服务就绪，再执行迁移
docker compose run --rm superset-app superset db upgrade

4. 重新创建管理员账号

docker compose run --rm superset-app superset fab create-admin

按提示输入用户名、密码、邮箱等信息即可。

5. 初始化Superset核心数据
   加载默认角色、权限及示例数据（可选）：

docker compose run --rm superset-app superset init

6. 启动所有Superset服务

docker compose up -d

7. 验证登录
   访问http://localhost:8088，使用刚创建的管理员账号登录，即可正常进入系统。

额外说明 #

• 官方Docker Compose部署时，正常流程会自动执行迁移和初始化，但如果遇到网络问题、容器启动顺序异常等情况，可能导致迁移失败，手动执行上述步骤可确保数据库结构完整。
• 避免直接进入容器执行flask fab create-admin，应通过docker compose run命令在正确的初始化上下文操作，防止环境变量或依赖缺失引发问题。

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