code: 'ERR_SSL_WRONG_VERSION_NUMBER'

完全なメッセージには、スレッド ID とソースのパスが含まれます（例：「60747095FFFF0000:error:0A00010B:SSL routines:tls_validate_record_header:wrong version number:../deps/openssl/openssl/ssl/record/methods/tlsany_meth.c:77:」）。そのため、コードで検索してください。tls.connect() と fetch() はコード ERR_SSL_WRONG_VERSION_NUMBER を設定し、https.request() は同じ理由を「write EPROTO …」としてコード EPROTO で報告します。

Node.js tls.connect / fetch (undici) — OpenSSL SSL_R_WRONG_VERSION_NUMBER; https.request reports it as write EPROTO

このエラーの意味

Node.js は TLS ハンドシェイクを開始しましたが、応答が TLS レコードではなかったため、OpenSSL がレコードヘッダーの検証中に失敗しました。相手はそのポートで平文で通信しています。HTTP サーバー、平文の HTTP を想定しているプロキシ、STARTTLS の前の SMTP サーバーなどです。名前とは裏腹に、証明書や TLS のバージョンには何も問題はありません。

発生する理由

• 平文の HTTP を返すポートに https:// で接続している

  よくある

  ローカルの開発用サーバー、TLS を終端するプロキシの背後にある社内サービス、または環境変数に書かれた誤ったポート番号が原因です。

• HTTPS_PROXY や npm の https-proxy が https:// で書かれている

  よくある

  ほとんどのフォワードプロキシは、クライアントから平文の HTTP を受け取り、CONNECT トンネルを開きます。プロキシの URL が https:// だと、クライアントはプロキシ自体と TLS を開始してしまいます。

• STARTTLS 用のポートに暗黙的 TLS で接続している

  ときどき

  ポート 587 または 25 で secure: true を設定したメールライブラリは、すぐに TLS を試みますが、サーバー側はまず平文の SMTP グリーティングを想定しています。

修正方法

1. 1.

   ポートがどのプロトコルで応答するかを確認する

   http:// でそのポートに問い合わせてください。応答があれば、http:// を使うか、本来の TLS ポートを使ってください。

   curl -si http://127.0.0.1:8080/ | head -1          # HTTP answers: use http:// or the TLS port
   openssl s_client -connect 127.0.0.1:8443 -brief </dev/null

2. 2.

   プロキシの URL は http:// で書く

   プロキシ URL のスキームが表すのは、宛先への接続ではなく、プロキシへの接続です。HTTPS の宛先には、トンネルを通じて引き続きエンドツーエンドの TLS が使われます。

   # Proxy URLs for HTTPS traffic normally start with http:// (CONNECT tunnel)
   export HTTPS_PROXY=http://proxy.example.net:3128
   npm config set https-proxy http://proxy.example.net:3128

3. 3.

   メール：587 では STARTTLS、465 では暗黙的 TLS を使う

   nodemailer では、secure: true はポート 465 用です。587 では secure: false のままにして、STARTTLS を必須にしてください。

   // SMTP: secure: true only for implicit TLS (465); 587 upgrades with STARTTLS
   import nodemailer from "nodemailer";
   
   const transport = nodemailer.createTransport({ host: "smtp.example.com", port: 587, secure: false, requireTLS: true });

← 署名エラーデータベースをすべて見る