SuperAPI AI 工具集

clickhouse-js-node-troubleshooting

通用与其它

查看项目

更新于 10-15 20:12

技能介绍

用途:该技能用于排查和解决 ClickHouse Node.js 客户端(@clickhouse/client)在 Node.js 运行时中遇到的常见问题,包括 Next.js Node 运行时 API 路由、React Server Components、Server Actions 及标准 Node.js 进程。不适用于浏览器客户端组件、Web Worker、Next.js Edge 运行时、Cloudflare Workers 或 @clickhouse/client-web。

主要能力:按症状索引定位问题并给出诊断与修复,涵盖 Socket Hang-Up/ECONNRESET、数据类型不匹配(大整数返回字符串、小数精度丢失、Date/DateTime 插入失败、UUID 插入 UInt128 报 CANNOT_PARSE_INPUT_ASSERTION_FAILED)、只读用户错误、代理/路径名 URL 混淆、TLS/证书错误、压缩未生效、日志无输出、查询参数未插值、FORMAT 子句与 SHOW POLICIES 错误。

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

限制:仅限 Node.js 运行时;浏览器/边缘环境应使用 @clickhouse/client-web。资料未提供具体版本号、完整修复代码与各参考文件内容。