bucket 必须手动创建，sdk 不提供创建接口；需通过 cli、ui 或管理 api 创建后，在 go 代码中严格匹配名称（大小写、空格、符号均敏感），并确保 token 显式绑定对应权限。
Bucket 名必须在 InfluxDB 里手动创建，SDK 不提供创建接口
influxdb-client-go/v2 的所有写入和查询操作都要求 bucket 已存在，它不带任何 CreateBucket 或类似方法。你得先通过 CLI、UI 或 InfluxDB 的管理 API 创建好 bucket，再在 Go 代码里引用它的名字。
常见错误现象：调 WriteAPI.WriteRecord 不报错但数据查不到，influx bucket list 也看不到目标 bucket —— 很可能压根没创建。
- CLI 创建（推荐）：
influx bucket create --name "my-bucket" --org "my-org" - UI 路径：Load Data → Buckets → Create Bucket，填名称、组织、保留策略（Retention）
- 注意 retention 默认是 0（无限），若设了比如 72h，过期数据会自动清理，别误设成 1h 导致监控点秒删
Go 代码里传 bucket 名大小写敏感，且不能带空格或不可见字符
bucket 参数不是“随便写个差不多的名字就行”，它必须和 UI 或 CLI 中显示的完全一致：大小写、连字符、下划线、甚至末尾空格都不能差。InfluxDB 2.x 返回 404 错误时，90% 是因为这个。
实操建议：
- 复制 bucket 名时，用鼠标双击全选，避免漏掉首尾空格
- 调试阶段加一行日志：
log.Printf("using bucket: '%s'", bucket)，确认实际传进去的是什么 - 别用变量拼接 bucket 名，尤其是从配置文件读取时，记得
strings.TrimSpace() - 如果 bucket 名含点号（
.）或斜杠（/），InfluxDB 会拒绝，改用连字符或下划线
WriteAPI 和 QueryAPI 都要显式传 bucket，但时机不同
client 初始化时不传 bucket，而是等到具体操作时才指定。这个分离设计容易搞混，导致参数错位。
正确姿势：
- 初始化 client：
influxdb2.NewClient(<code>url,token) —— 这里只传 URL 和 token - 创建 WriteAPI：
client.WriteAPIWithOptions(<code>org,bucket, opts) —— org 和 bucket 在这里传 - QueryAPI 查询时：
queryAPI.Query(ctx, `from(bucket:"my-bucket")|>range(start:-1h)`)—— bucket 写在 Flux 字符串里，不是函数参数 - 注意：Flux 字符串里的 bucket 名也要和实际一致，且必须用双引号包裹，如
"my-bucket"，不能用单引号或不加引号
bucket 权限必须由 token 显式绑定，光有 org 不行
token 不是万能钥匙。即使你用的是 all-access token，也得在 UI 的 Tokens 页面里，手动勾选该 token 对目标 bucket 的 Read / Write 权限。否则写入返回 403，查询返回空结果且 err == nil。
检查步骤：
- 进 UI → Load Data → Tokens，找到你用的 token，点 “Edit”
- 在 “Permissions” 区域，确认勾选了对应 bucket 的 “Write”（写入）或 “Read”（查询）
- org 参数填的是组织名（不是 ID），可在右上角头像 → Organizations 里核对，大小写同样敏感
- 如果用的是临时 token 或自动化脚本生成的 token，务必确认生成时指定了 bucket scope，而不是仅 org scope
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
