ClickHouse Node.js 故障排查

原名：clickhouse-js-node-troubleshooting

定位 ClickHouse JavaScript 客户端的连接、超时、流和查询错误。

中文 Skills 技能说明

适合线上报错和性能异常；先读取真实错误、请求范围和服务端日志，再做最小修复并复测，不在日志中暴露连接串。ClickHouse 与 chDB 可在用户自己的环境使用；涉及 ClickHouse Cloud 或托管 PostgreSQL 时，账户、网络、区域、费用与数据位置由用户确认。执行前应读取项目现状和官方文档，输出目标、依据、影响、验证结果与回退方式；没有真实证据时明确说明未知，不编造配置、数据或成功状态。 创建、修改、训练、部署、发布、迁移、删除或产生费用的操作，必须先展示具体目标和差异并获得人工确认。 代码、日志、令牌、连接串、模型、数据集和企业资料按敏感内容处理，只读取任务所需范围，上传或外发前完成授权、脱敏和最小化。

上游能力依据

上游原始适用说明：Troubleshoot and resolve common issues with the ClickHouse Node.js client (@clickhouse/client). Use this skill whenever a user reports errors, unexpected behavior, or configuration questions involving the Node.js client specifically — including socket hang-up errors, Keep-Alive problems, stream handling issues, data type mismatches, read-only user restrictions, proxy/TLS setup problems, or long-running query timeouts. Trigger even when the user hasn't precisely named the issue; vague symptoms like "my inserts keep failing" or "connection drops randomly" in a Node.js context are strong signals to use this skill. Do NOT use for browser/Web client issues.

上游 SKILL.md 主要章节（保留原文标题）：

使用边界

先复现问题并固定测试范围，再生成或执行测试。测试通过只能证明已覆盖的场景，不能代替生产环境验收。

作者、翻译与许可证

原作者
ClickHouse, Inc. 与 ClickHouse/agent-skills contributors
中文翻译
CEOFans翻译
许可证
Apache-2.0
上游来源
https://github.com/ClickHouse/agent-skills/tree/5aec3114379671f33b1c502a51d420a0729c8172/skills/clickhouse-js-node-troubleshooting

适用范围

平台：linux、macos、windows；标签：测试与质量、ClickHouse Node.js 故障排查

安全提示

基础静态扫描不等于绝对安全。技能可能调用命令、浏览器、云服务或本地文件，请在最小权限环境中使用，高风险操作必须人工确认。

如发现侵权、许可证或安全问题，可在本页前台提交投诉，管理员复核后可立即下架。