应使用com.influxdata:influxdb-client-java:4.19.0（JDK11+），删掉org.influxdb旧依赖；连接需正确配置url、token、org、bucket四参数；WriteApi需设flushInterval并close；QueryApi用Flux语法且注意UTC时区。
Java项目里加InfluxDBClient依赖，Maven怎么写才不冲突
直接用 influxdb-client-java 官方库，别碰旧版 influxdb-java（它不支持InfluxDB 2.x的token鉴权和Line Protocol v2）。常见错误是混用两个库，导致 InfluxDBClientFactory.create() 找不到、或 WriteApi 写入时抛 NullPointerException。
- 只保留一个依赖：
com.influxdata:influxdb-client-java:4.19.0（建议用最新稳定版，看release页） - 删掉所有带
org.influxdb:前缀的老依赖（比如influxdb-java） - 如果用了Spring Boot，避免自动配置干扰：加
@SpringBootApplication(exclude = InfluxDbAutoConfiguration.class)或干脆不用starter，自己配客户端 - 注意JDK版本：4.x客户端最低要求JDK 11；若还在用JDK 8，只能降级到3.5.0（但会丢掉
QueryApi流式查询等新特性）
连接InfluxDB 2.x必须设对这4个参数
连不上八成是这四个值填错或漏了——url、token、org、bucket。尤其容易把 org 写成用户名，或把 bucket 当成数据库名硬套MySQL习惯。
-
url必须带协议和端口，例如"http://localhost:8086"（不是"localhost:8086"） -
token是UI里「Data > Tokens」生成的完整字符串，含前缀如"mytoken==..."，不能只复制等号后部分 -
org是组织名（Organization），不是用户邮箱，也不是admin这类默认值（除非你手动建过同名org） -
bucket是存储桶名，必须已存在（通过UI或influx bucket create命令创建），不能运行时自动建
实操示例：
InfluxDBClient client = InfluxDBClientFactory.create( "http://localhost:8086", "your-token-here==".toCharArray(), "my-org-name", "my-bucket-name" );
WriteApi写数据卡住或丢点？检查超时和批处理配置
默认 WriteApi 是异步+批处理的，没显式调用 flush() 或等 close()，数据可能一直缓在内存里不发出去——本地调试看着“没写入”，其实是还没刷。
立即学习“Java免费学习笔记（深入）”；
- 开发阶段加
.writeOptions(WriteOptions.builder().batchSize(1).flushInterval(1000).build())，强制每条都立即发 - 生产环境别关批处理，但要把
flushInterval设为合理值（比如5000ms），避免高频小请求压垮服务 - 务必在应用退出前调用
writeApi.close()，否则JVM退出时未刷出的数据就丢了 - 如果写入后查不到，先确认时间戳字段：InfluxDB默认用纳秒级时间戳，Java传
Instant.now()没问题，但用System.currentTimeMillis()得乘1_000_000转换
QueryApi查不出结果？重点看Flux语法和时间范围
返回空列表却不报错，大概率是Flux脚本写错或时间窗口太窄。InfluxDB 2.x查数据不用SQL，用的是函数式Flux语言，大小写、括号、管道符都不能错。
- 最简可用查询模板：
"from(bucket:\"my-bucket-name\") |> range(start: -1h) |> filter(fn: (r) => r._measurement == \"cpu\")" -
start和stop时间必须用相对时间（如-1h）或RFC3339格式（如"2024-01-01T00:00:00Z"），不能用毫秒数字 - 测量名（
_measurement）、字段名（_field）、标签名（_value）都是下划线开头，且区分大小写 - 用
QueryApi.query()返回的是List<fluxtable></fluxtable>，得遍历table.getRecords()才拿到实际数据行，不是直接get(0)
容易被忽略的一点：InfluxDB默认时区是UTC，如果你写入时没指定时区，查的时候用本地时间范围可能跨不到数据——宁可全用UTC时间操作。
