SuperAPI AI 工具集

clickhouse-js-node-troubleshooting

通用与其它

查看项目

更新于 10-15 19:49

技能介绍

用途:该技能用于诊断和解决 ClickHouse Node.js 客户端(@clickhouse/client)在 Node.js 运行时中出现的常见错误与异常。仅适用于 Node.js 运行时,包括 Next.js Node 运行时 API 路由、React Server Components、Server Actions 及标准 Node.js 进程;不适用于浏览器客户端组件、Web Worker、Next.js Edge 运行时、Cloudflare Workers 或 @clickhouse/client-web,浏览器/边缘环境应改用 @clickhouse/client-web。

主要能力:按症状定位问题并给出诊断与修复建议,覆盖以下问题索引:Socket Hang-Up / ECONNRESET(socket hang up、ECONNRESET、间歇性连接中断、长查询超时);数据类型不匹配(大整数返回字符串、小数精度丢失、Date/DateTime 插入失败、向 UInt128 列插入 UUID 报 CANNOT_PARSE_INPUT_ASSERTION_FAILED);只读用户错误(readonly=1 用户使用响应压缩时报错);代理/路径名 URL 混淆(选错数据库、带路径前缀的代理后请求失败);TLS/证书错误(TLS 握手失败、证书验证问题、双向 TLS 配置);压缩未生效(请求或响应的 GZIP 压缩未激活);日志无输出(需要自定义日志集成);查询参数未插值(参数化查询不工作、SQL 注入顾虑);FORMAT 子句 / SHOW POLICIES 错误(重复 FORMAT 导致语法错误,或即使提供 format 仍 SHOW [ROW] POLICIES 失败)。

使用方式:先根据症状匹配问题索引并阅读对应参考文件;先说明可能的成因再给出修复方案;标注修复所需的最低客户端版本并与用户提供的版本核对;仅在修复依赖版本且未知版本时询问,否则直接协助。

限制:仅限 Node.js 运行时;具体修复步骤、版本号与代码示例需查阅对应参考文件及官方文档,本资料未提供完整细节。