Docker环境下HomeAssistant无法写入InfluxDB的问题排查求助

核心原因 #

你当前使用的是InfluxDB v1版本的配置格式，但实际部署的是InfluxDB v2.6.1，两者API协议、认证方式完全不兼容，这是导致401未授权错误的根本原因。

一、修正HA的InfluxDB配置（适配v2版本） #

InfluxDB v2需要使用api_version: 2指定版本，同时用API Token替代用户名密码认证，还要明确组织（Org）和Bucket信息：

1. 先在InfluxDB UI中完成以下操作：
   • 创建一个组织（Organization）
   • 创建目标Bucket（比如命名为home_assistant）
   • 创建具备该Bucket写入权限的API Token（创建时选择Write权限并关联目标Bucket）
2. 修改HA的configuration.yaml配置：

influxdb:
  api_version: 2
  host: 192.168.1.110
  port: !secret influx_port  # 确认端口为InfluxDB v2默认的8086（或你自定义映射的端口）
  ssl: false  # 未开启HTTPS时设为false，开启则设为true
  token: !secret influx_token  # 填入你创建的API Token
  organization: "你的组织名称"
  bucket: "home_assistant"

3. 重启HomeAssistant使配置生效

二、排查401错误的其他可能性 #

• 确认API Token权限：必须确保Token拥有目标Bucket的写入权限，创建时不要选错权限范围
• 检查网络连通性：在HA容器内执行curl http://192.168.1.110:8086/api/v2/buckets，再用Token认证测试：curl -H "Authorization: Token 你的Token内容" http://192.168.1.110:8086/api/v2/buckets，如果能返回Bucket列表说明网络和Token有效
• 核对端口映射：确认InfluxDB容器的端口映射（宿主机端口→容器8086）与HA配置中的端口一致

三、确认HA是否向Bucket写入数据 #

1. 查看HA日志：重启HA后，搜索日志中"InfluxDB"关键词，若出现Successfully connected to InfluxDB则说明连接正常
2. InfluxDB UI查询：进入InfluxDB的Data Explorer，选择目标Bucket，用Flux语句查询sun.sun实体数据：

from(bucket: "home_assistant")
  |> range(start: -10m)
  |> filter(fn: (r) => r._measurement == "sun.sun")

若能返回数据，说明写入成功
3. 查看Bucket存储：在InfluxDB的Buckets页面，观察home_assistant桶的"Used"空间，若持续增长则说明有数据写入

额外注意事项 #

• 不要用InfluxDB的登录用户名密码作为HA的认证凭据，v2版本仅支持API Token
• 若需兼容v1协议，需手动开启InfluxDB的v1兼容模式，但更推荐直接使用v2原生配置

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