Guide de dépannage du client Node.js ClickHouse
Référence : https://clickhouse.com/docs/integrations/javascript
⚠️ Runtime Node.js uniquement. Cette skill couvre le package
@clickhouse/clients'exécutant dans un runtime Node.js exclusivement — y compris les routes d'API Next.js Node runtime, React Server Components, Server Actions, et les processus Node.js standard. N'appliquez pas cette skill aux composants client du navigateur, Web Workers, Next.js Edge runtime, Cloudflare Workers, ou toute utilisation de@clickhouse/client-web. Pour les environnements navigateur/edge, le package correct est@clickhouse/client-web.
Comment utiliser cette skill
- Identifiez le problème — associez les symptômes à l'Index des problèmes ci-dessous et lisez le fichier de référence correspondant.
- Commencez par le diagnostic — expliquez la cause probable du problème avant de donner la solution.
- Notez les contraintes de version — signalez si une solution nécessite une version client minimum et vérifiez-la par rapport à celle fournie par l'utilisateur.
- Ne demandez que ce qui manque — si la solution dépend de la version et que vous ne connaissez pas sa version, demandez ; sinon, aidez immédiatement.
Index des problèmes
Identifiez le problème de l'utilisateur dans la liste ci-dessous et lisez le fichier de référence correspondant pour obtenir des étapes de dépannage détaillées.
| Problème | Symptômes | Fichier de référence |
|---|---|---|
| Socket Hang-Up / ECONNRESET | socket hang up, ECONNRESET, interruptions de connexion intermittentes, timeout de requêtes longues |
reference/socket-hangup.md |
| Incompatibilités de types de données | Grands entiers retournés sous forme de chaînes, perte de précision décimale, échecs d'insertion Date/DateTime | reference/data-types.md |
| Erreurs utilisateur en lecture seule | Erreurs lors de l'utilisation de la compression de réponse avec les utilisateurs readonly=1 |
reference/readonly-users.md |
| Confusion Proxy / Pathname URL | Mauvaise base de données sélectionnée, requêtes échouant derrière un proxy avec préfixe de chemin | reference/proxy-pathname.md |
| Erreurs TLS / Certificat | Échecs de négociation TLS, problèmes de vérification de certificat, configuration TLS mutuel | reference/tls.md |
| Compression ne fonctionne pas | Compression GZIP non activée pour les requêtes ou réponses | reference/compression.md |
| Journalisation n'affichant rien | Aucune sortie de journal, intégration de logger personnalisé nécessaire | reference/logging.md |
| Paramètres de requête non interpolés | Requêtes paramétrées ne fonctionnant pas, préoccupations concernant l'injection SQL | reference/query-params.md |