Vault Raft模式初始化失败：配置地址为空错误排查

云原生阿岚

2026-8-3

问题

在新机器上安装Vault后，使用以下配置文件：

cluster_addr  = "cor-infravault101.test.ag3:8201"
api_addr      = "cor-infravault101.test.ag3:8200"
disable_mlock = true

listener "tcp" {
  address            = "0.0.0.0:8200"
  cluster_address    = "0.0.0.0:8201"
  tls_cert_file      = "/opt/vault/tls/server.crt"
  tls_key_file       = "/opt/vault/tls/server.key"
}

storage "raft" {
  path    = "/opt/vault/data"
  node_id = "1"

  retry_join {
    leader_api_addr         = "https://cor-infravault102.test.ag3:8200"
    leader_client_cert_file = "/opt/vault/tls/server.crt"
    leader_client_key_file  = "/opt/vault/tls/server.key"
    leader_ca_cert_file     = "/opt/vault/tls/ca.crt"
  }
  retry_join {
    leader_api_addr         = "https://cor-infravault103.test.ag3:8200"
    leader_client_cert_file = "/opt/vault/tls/server.crt"
    leader_client_key_file  = "/opt/vault/tls/server.key"
    leader_ca_cert_file     = "/opt/vault/tls/ca.crt"
  }
}

ui = true

执行vault status显示正常，但运行vault operator init时出现如下错误：

Error initializing: Error making API request.

URL: PUT https://cor-infravault101.test.ag3:8200/v1/sys/init Code: 400. Errors:

* could not start clustered storage: empty address in configuration: {Voter 1 }

原因及解决方法

核心原因：Raft存储配置中缺少当前节点的address参数。虽然设置了node_id = "1"，但未指定该节点对应的集群通信地址，导致Vault初始化集群时无法识别节点的网络位置，触发地址为空的错误。
修复步骤：在storage "raft"块中添加address配置，值与当前节点的cluster_addr保持一致即可，修改后的配置片段如下：

storage "raft" {
  path    = "/opt/vault/data"
  node_id = "1"
  address = "cor-infravault101.test.ag3:8201" # 添加该行配置

  retry_join {
    # 原有内容保持不变
  }
  retry_join {
    # 原有内容保持不变
  }
}