org参数必须填name，不能是ID或空字符串；InfluxDB v2.x只认UI中Organizations页面显示的org name（大小写、下划线敏感），填ID或空字符串均导致404；token须在UI中显式绑定该org及对应bucket的读写权限。
org参数必须填name，不能是ID或空字符串
InfluxDB v2.x 的 org 参数只认 organization 的 name，不是 UUID 或 ID 字段。UI 上右上角头像 → Organizations 页面里显示的名称（比如 my-org）才是合法值；点进去看到的 ID: 0xabc123... 完全不能用。填错直接 404 Not Found，且错误信息不提示具体原因。
- 如果 org 名含空格或特殊字符（如
My Org Prod），必须在 UI 中创建时就用下划线替代，SDK 不做 URL 编码 - 哪怕只有一个 org，也不能传空字符串
""或"default"—— InfluxDB 不会 fallback，默认组织不存在 - 命令行查当前 org 列表：
influx org find（需先influx auth login）
client 初始化时不传 org，write/query 时才绑定
influxdb2.NewClient() 只接受 URL 和 token，org 是后续调用 WriteAPI() 或 QueryAPI().Query() 时才传入的参数。写成 NewClient(url, token, org, bucket) 会编译失败，因为该函数签名根本不存在。
- 正确写法：
writeAPI := client.WriteAPI("my-org-name", "my-bucket-name") - 错误写法：
client := influxdb2.NewClient(url, token, "my-org", "my-bucket")—— Go 报too many arguments - 同一个 client 可复用于多个 org/bucket 组合，无需为每个 org 新建 client
org 权限和 token 必须显式关联
token 不是全局有效的，它必须在 UI 的 Load Data → Tokens 页面中，明确勾选对应 org 下的目标 bucket 的 Read/Write 权限。只生成 token、没绑定 org 和 bucket，连接能通但写入必 401 Unauthorized。
- 检查方式：在 UI 中打开 token 详情页，看 “Organizations” 和 “Buckets” 列表是否包含你代码里写的那个
org和bucket - CLI 创建带权限 token：
influx auth create --org "my-org-name" --bucket "my-bucket" --read-buckets --write-buckets - org 名大小写敏感，
MyOrg和myorg是两个不同 org
调试时如何快速验证 org 是否生效
最直接的办法是绕过 SDK，用 curl 手动触发一个最小查询，确认 org 能被识别：
curl -X POST "http://localhost:8086/api/v2/query?org=my-org-name" \ -H "Authorization: Token your-token-here" \ -H "Content-Type: application/vnd.flux" \ --data 'from(bucket:"my-bucket") |> range(start: -1m) |> limit(n:1)'
如果返回 404，八成是 org 名拼错；如果返回 401，说明 token 没绑该 org；只有返回正常 Flux 表结构，才能继续往下查写入逻辑。
最容易被忽略的是：org 名必须和 UI 中显示的一模一样，包括连字符、下划线、大小写——少一个字符，整个链路就静默失败。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
