Windows下Apache Superset数据源无法加载，解密密钥错误

问题场景 #

Windows系统下通过Docker Compose安装Apache Superset，按官方文档操作时初始化步骤报错，日志最终触发ValueError: Invalid decryption key，superset_init进程退出码为1，界面中数据源无法正常显示。

报错核心日志片段：

File "/usr/local/lib/python3.9/site-packages/sqlalchemy_utils/types/encrypted/encrypted_type.py", line 128, in decrypt
    raise ValueError('Invalid decryption key')
ValueError: Invalid decryption key
superset_init exited with code 1

解决方案 #

1. 清理旧数据与不一致密钥 #

• 停止并删除所有Superset容器及关联卷：

  docker-compose down -v
  

• 删除本地目录下的.env文件（若存在自定义配置），避免旧密钥残留。

2. 生成并配置统一加密密钥 #

• 生成符合要求的32位十六进制密钥：

  python -c "import secrets; print(secrets.token_hex(16))"
  

• 在Docker Compose目录下创建或编辑.env文件，添加以下配置（替换为你生成的密钥）：

  SECRET_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  SUPERSET_SECRET_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  

  确保两个密钥值完全一致，避免容器间密钥不匹配

3. 重新部署并初始化Superset #

• 启动容器：

  docker-compose up -d
  

• 若自动初始化仍失败，手动执行初始化命令：

  docker-compose exec superset_app superset db upgrade
  docker-compose exec superset_app superset init
  

4. 验证修复结果 #

• 访问Superset Web界面，检查数据源列表是否正常加载
• 查看初始化日志确认无报错：

  docker-compose logs superset_init
  

问题原因 #

该错误源于加密密钥不一致：要么是不同容器使用了不同的SECRET_KEY/SUPERSET_SECRET_KEY，要么是旧数据库中存在用其他密钥加密的数据，导致初始化时解密数据库内容失败。清理旧数据并统一密钥后，Superset就能正常完成初始化并加载数据源。

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