Docker部署Metabase+PostgreSQL遇登录401"Unauthenticated"错误

可能的原因及修复步骤 #

1. 核对Metabase与Postgres的连接配置 #

• 确保docker-compose.yml里Metabase的数据库连接参数完全正确，MB_DB_HOST、MB_DB_USER、MB_DB_PASS、MB_DB_NAME这几个环境变量必须和Postgres容器的配置完全匹配。
• 确认Postgres容器正常启动，可进入Metabase容器执行ping <postgres-service-name>测试连通性，确保两个容器网络互通。

2. 清除浏览器缓存与Cookie #

• 浏览器可能缓存了无效的会话数据，直接清空当前域名下的Cookie，或者用无痕模式重新尝试登录。

3. 检查Postgres中Metabase的初始化数据 #

• 进入Postgres容器，连接Metabase对应的数据库，查询管理员用户是否存在：

  docker exec -it <postgres容器名> psql -U <Metabase数据库用户名> -d <Metabase数据库名>
  SELECT id, email FROM core_user;
  

  如果查询不到初始化时创建的管理员用户，说明初始化过程异常，可删除Postgres的持久化数据卷后重新启动容器，重新执行初始化。

4. 排查自定义JWT配置（若有） #

• 如果配置了JWT认证，检查MB_JWT_*系列环境变量是否正确，是否和初始化设置冲突。未使用JWT的话，确保没有误配置相关变量。

5. 同步容器与主机时间 #

• 容器时间与主机不一致可能导致会话过期异常，分别执行以下命令对比容器和主机时间：

  docker exec -it <Metabase容器名> date
  date # 主机端执行
  

  若时间不一致，在docker-compose.yml的Metabase服务中添加时间同步挂载：

  volumes:
    - /etc/localtime:/etc/localtime:ro
  

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