PHP 7.4 连 InfluxDB 2.x 必须使用 influxdata/influxdb-client-php，因 influxdb/influxdb-php 仅支持 1.x 的 user/pass 认证，与 2.x 的 Token 认证协议不兼容，会导致 401 或 404；安装需执行 composer require influxdata/influxdb-client-php，初始化 Client 必须传入 url、token、org、bucket 四要素，且 token 需在 UI 中生成并绑定对应 bucket 权限，时间戳须为纳秒整数或 RFC3339 格式，字段值禁止 null，标签值仅支持字符串。
PHP 7.4 连 InfluxDB 2.x 必须用 influxdata/influxdb-client-php，不能用 influxdb/influxdb-php —— 后者只认 1.x 的 user/pass 认证，连 2.x 会直接返回 401 Unauthorized 或 404 Not Found，不是配置错，是协议根本不通。
确认你装的是 influxdata/influxdb-client-php
Composer 安装命令必须是：
composer require influxdata/influxdb-client-php
常见误操作：
- 敲成
composer require influxdb/influxdb-php（这是 1.x 库，已废弃） - 敲成
composer require influxdb/influxdb-client（包名不存在，会报错） - 没清 composer cache 就重试，旧缓存可能拉错版本
装完检查 vendor/composer/autoload_psr4.php 里是否有 "InfluxDB2\" => ["vendor/influxdata/influxdb-client-php/src/"]，没有就是装错了。
立即学习“PHP免费学习笔记（深入）”；
初始化 Client 必须带 token、org、bucket 三要素
InfluxDB 2.x 彻底弃用用户名密码，改用 token 绑定权限。漏掉任意一个，$client->getHealthApi()->getHealth() 就会立即失败，而不是等到写入才报错。
关键点：
-
token要从 UI 的 Load Data → Tokens 复制完整字符串（形如abc123...xyz==），手输或截断必 401 -
org是组织名（默认是安装时填的邮箱，但可能被改过），不是用户名；可在右上角头像 → Organizations 确认 -
bucket区分大小写，且该 token 必须在 Tokens → Permissions 里勾选对应 bucket 的读/写权限
示例代码（注意命名空间和反斜杠）：
$client = new InfluxDB2Client([
"url" => "http://localhost:8086",
"token" => "your-token-here==",
"org" => "my-org@example.com",
"bucket" => "my-bucket"
]);写入数据时字段类型和时间戳极易静默失败
writeRecords() 或 writePoint() 出错时默认不抛异常，整批丢弃还无提示——这是最隐蔽的坑。
必须检查：
- 时间戳：传
int表示纳秒（如time() * 1e9），或留空由服务端打；传字符串只能是 RFC3339 格式（如"2024-05-20T10:30:00Z"），"Y-m-d H:i:s"直接拒收 - 字段值：不能为
null，空值要显式写0或""；布尔值必须是小写true/false，"true"或TRUE都解析失败 - 标签（tags）值只能是字符串，数字或布尔会被转成字符串，但最好主动 cast 避免歧义
调试建议：写入前用 print_r($point->toLineProtocol()) 打印原始行协议，对照 Line Protocol 文档 逐字核对。
PHP 7.4 下要注意 autoloader 和类名写法
7.4 对命名空间和自动加载更敏感，常见错误：
- 忘记
require_once __DIR__ . '/vendor/autoload.php';，或路径写错（比如少个__DIR__） - 类名漏写反斜杠：
new InfluxDB2Client()错，必须是new InfluxDB2Client() - 用了 Laravel/Symfony 却手动
require，应走框架容器注入，否则可能冲突
运行 php -v 确认确实是 PHP 7.4.x（不是 8.x），因为部分新 client 版本已不兼容 7.4，若报 ParseError 或 Class not found，可指定旧版安装：composer require influxdata/influxdb-client-php:^3.0（3.x 支持 7.4，4.x 起要求 PHP 8.0+）。
真正卡住的地方往往不是连接本身，而是 token 权限没开全、bucket 名拼错、或时间戳格式肉眼难辨——建议先用 curl 手动发一条 Line Protocol 数据验证服务端是否通，再回 PHP 排查。
