【Node.js】socket.readyStateで学ぶソケット通信の基礎

2025-05-01

具体的には、socket.readyState は以下のいずれかの値を持ちます。

  • 3 (CLOSED)
    ソケットが完全にクローズされた状態です。これ以上データの送受信はできません。ソケットに関連するリソースは解放されています。

  • 2 (CLOSING)
    ソケットがクローズ処理を開始した状態です。この状態の間は、まだデータが送信される可能性がありますが、新しいデータの送信は推奨されません。

  • 1 (OPEN)
    ソケットが正常に接続され、データ転送の準備ができている状態です。データの送受信が可能です。

  • 0 (CONNECTING)
    ソケットが接続を確立しようとしている状態です。まだリモートエンドポイントへの接続が完了していません。

プログラミングにおいては、この socket.readyState を監視することで、ソケットの状態に応じて適切な処理を行うことができます。例えば、接続が確立した (OPEN) 後にデータを送信したり、接続がクローズした (CLOSED) 際に後処理を行ったりする際に利用します。

以下は、socket.readyState の利用例です。

const net = require('net');

const client = net.createConnection({ host: 'example.com', port: 80 }, () => {
  console.log('接続が確立しました!');
  console.log(`ソケットの状態: ${client.readyState}`); // 1 (OPEN) が表示されるはずです。
  client.write('GET / HTTP/1.1\r\nHost: example.com\r\nConnection: close\r\n\r\n');
});

client.on('data', (data) => {
  console.log('受信したデータ:', data.toString());
});

client.on('end', () => {
  console.log('接続が閉じられました。');
  console.log(`ソケットの状態: ${client.readyState}`); // 2 (CLOSING) または 3 (CLOSED) が表示される可能性があります。
});

client.on('close', () => {
  console.log('ソケットが完全に閉じられました。');
  console.log(`ソケットの状態: ${client.readyState}`); // 3 (CLOSED) が表示されます。
});

client.on('error', (err) => {
  console.error('ソケットエラー:', err);
});

console.log(`接続前のソケットの状態: ${client.readyState}`); // 0 (CONNECTING) が表示されるはずです。


一般的なエラーとトラブルシューティング

    • 考えられる原因
      • 指定したホスト名やIPアドレスが間違っている。
      • 指定したポート番号が間違っている。
      • ファイアウォールが接続をブロックしている (クライアント側またはサーバー側)。
      • ネットワークの問題 (DNS解決の失敗、ルーティングの問題など)。
      • サーバーがダウンしている、またはリッスンしていない。
    • トラブルシューティング
      • net.connect() または net.createConnection() に指定したホストとポートが正しいか確認してください。
      • pingコマンドやtelnetコマンドを使用して、サーバーに到達できるか確認してください。
      • ファイアウォールの設定を確認し、Node.jsアプリケーションからの接続が許可されているか確認してください。
      • サーバー側のログを確認し、エラーが発生していないか確認してください。
      • DNS解決が正常に行われているか確認してください (例えば、指定したホスト名で nslookup を実行するなど)。
  1. 接続が途中で切断される (readyState が 1 から 2 または 3 に変わる)

    • 考えられる原因
      • サーバー側が意図的に接続をクローズした。
      • ネットワークの不安定さによるタイムアウト。
      • アイドルタイムアウト (一定時間データが送受信されない場合にサーバーが接続を切断する設定)。
      • クライアント側またはサーバー側のアプリケーションでエラーが発生し、ソケットが強制的に閉じられた。
      • ネットワーク機器 (ルーター、スイッチなど) の問題。
    • トラブルシューティング
      • サーバー側のログを確認し、接続がクローズされた理由が記録されていないか確認してください。
      • ネットワークの接続状況を確認してください (他のネットワーク接続は安定しているかなど)。
      • アイドルタイムアウトの設定を確認し、必要であれば調整してください。
      • クライアント側とサーバー側のアプリケーションのログを確認し、エラーが発生していないか確認してください。
      • より長いタイムアウトを設定することを検討してください (socket.setTimeout())。ただし、根本的な問題を解決するわけではありません。
      • 'error' イベントリスナーをソケットに追加し、エラーの詳細を把握してください。
  2. データ送信中にエラーが発生する (readyState が 1 の状態だが書き込みが失敗する)

    • 考えられる原因
      • ソケットがすでにクローズ処理に入っている (readyState が 2 になっている)。
      • ネットワークの問題によりデータが送信できない。
      • サーバー側が予期しないシャットダウンをした。
    • トラブルシューティング
      • データを書き込む前に socket.readyState が 1 (OPEN) であることを確認してください。
      • 'error' イベントリスナーでエラーを捕捉し、適切な処理を行ってください。
      • ネットワークの接続状況を確認してください。
  3. クローズ処理が完了しない (readyState が 2 のままになる)

    • 考えられる原因
      • バッファに残っているデータがまだ送信中である。
      • ソケットの 'drain' イベントを適切に処理していない (書き込みバッファが一杯になった場合に発生するイベント)。
      • 相手側がクローズ処理を完了していない。
    • トラブルシューティング
      • socket.end() を呼び出して、送信側のクローズ処理を開始しているか確認してください。
      • 'drain' イベントリスナーを実装し、書き込みバッファが空になった後にクローズ処理を行うようにしてください。
      • 相手側のアプリケーションのログを確認し、クローズ処理が正常に行われているか確認してください。

トラブルシューティングのヒント

  • ドキュメントの確認
    Node.jsの net モジュールや tls モジュールの公式ドキュメントを再度確認し、各メソッドやイベントの挙動を理解することも重要です。
  • シンプルなテスト
    まずは簡単なクライアントとサーバーを作成し、基本的な接続とデータの送受信が正常に行えるかテストしてみるのが有効です。
  • ネットワーク監視ツール
    tcpdump や Wireshark などのネットワーク監視ツールを使用すると、実際にどのようなネットワークパケットが送受信されているかを確認でき、問題の切り分けに役立ちます。
  • ログ出力
    ソケットの状態 (readyState) や発生したエラー、関連する情報をログに出力するようにしましょう。問題発生時の追跡に役立ちます。
  • エラーイベントの活用
    ソケットオブジェクトには 'error' イベントがあります。このイベントリスナーを登録することで、接続やデータ送受信中に発生したエラーを捕捉し、詳細な情報を得ることができます。


例1: クライアント側の接続状態の監視

この例では、クライアントがサーバーに接続を試み、接続状態の変化を監視します。

const net = require('net');

const client = net.createConnection({ host: 'localhost', port: 3000 }, () => {
  console.log('クライアント: サーバーに接続しました!');
  console.log(`クライアント: 接続後のreadyState: ${client.readyState}`); // 1 (OPEN)
  client.write('こんにちは、サーバー!\r\n');
});

console.log(`クライアント: 接続前のreadyState: ${client.readyState}`); // 0 (CONNECTING)

client.on('data', (data) => {
  console.log(`クライアント: 受信したデータ: ${data.toString()}`);
  client.end(); // データを受信したら接続を終了
});

client.on('end', () => {
  console.log('クライアント: サーバーとの接続を閉じます。');
  console.log(`クライアント: endイベント後のreadyState: ${client.readyState}`); // 2 (CLOSING)
});

client.on('close', () => {
  console.log('クライアント: 接続が完全に閉じられました。');
  console.log(`クライアント: closeイベント後のreadyState: ${client.readyState}`); // 3 (CLOSED)
});

client.on('error', (err) => {
  console.error('クライアント: ソケットエラー:', err);
});

このコードでは、net.createConnection でサーバーへの接続を開始する際に readyState0 (CONNECTING) になります。接続が成功すると 'connect' イベントが発生し、その時点で readyState1 (OPEN) に変わります。client.end() を呼び出すと、クライアントはFINパケットを送信し、サーバーへの書き込みを終了し、readyState2 (CLOSING) に移行します。最終的に接続が完全に閉じられると 'close' イベントが発生し、readyState3 (CLOSED) になります。

例2: サーバー側の接続状態の監視とクライアントの状態確認

この例では、サーバーがクライアントからの接続を受け付け、接続されたソケットの readyState を監視します。

const net = require('net');
const server = net.createServer((socket) => {
  console.log('サーバー: クライアントが接続しました。');
  console.log(`サーバー: 新しいソケットのreadyState: ${socket.readyState}`); // 1 (OPEN)

  socket.on('data', (data) => {
    console.log(`サーバー: 受信したデータ: ${data.toString()}`);
    socket.write('データを処理しました。\r\n');
  });

  socket.on('end', () => {
    console.log('サーバー: クライアントが接続を閉じました。');
    console.log(`サーバー: endイベント後のソケットのreadyState: ${socket.readyState}`); // 2 (CLOSING)
  });

  socket.on('close', () => {
    console.log('サーバー: クライアントとの接続が完全に閉じられました。');
    console.log(`サーバー: closeイベント後のソケットのreadyState: ${socket.readyState}`); // 3 (CLOSED)
  });

  socket.on('error', (err) => {
    console.error('サーバー: ソケットエラー:', err);
  });

  // 一定時間後にクライアントの状態を確認する
  setTimeout(() => {
    console.log(`サーバー: 5秒後のクライアントソケットのreadyState: ${socket.readyState}`);
    if (socket.readyState === 1) {
      socket.write('まだ接続していますか?\r\n');
    }
  }, 5000);
});

server.listen(3000, () => {
  console.log('サーバー: ポート3000でリッスンを開始しました。');
});

サーバーがクライアントからの接続を受け付けると、新しいソケットオブジェクトが作成され、その readyState は通常すぐに 1 (OPEN) になります。サーバーはクライアントからのデータを受信したり、データを送信したりします。クライアントが接続を閉じると、サーバー側のソケットでも 'end' イベントが発生し、readyState2 (CLOSING) に、最終的に 'close' イベントで 3 (CLOSED) に変わります。setTimeout を使用して、一定時間後にクライアントのソケットの状態を確認する例も示しています。

例3: 接続試行時のタイムアウト処理 (readyState が 0 のままの場合)

この例では、接続を試みて一定時間経過しても readyState1 (OPEN) にならない場合に、タイムアウトとして処理する方法を示します。

const net = require('net');

const client = net.createConnection({ host: 'nonexistent.example.com', port: 80 });

console.log(`クライアント: 接続試行前のreadyState: ${client.readyState}`); // 0 (CONNECTING)

let timeoutId = setTimeout(() => {
  if (client.readyState !== 1) {
    console.log('クライアント: 接続がタイムアウトしました。');
    client.destroy(); // ソケットを強制的に破棄
  }
}, 5000); // 5秒後にタイムアウト判定

client.on('connect', () => {
  console.log('クライアント: 接続に成功しました!');
  clearTimeout(timeoutId); // 接続成功したのでタイムアウトタイマーをクリア
  client.end();
});

client.on('error', (err) => {
  console.error('クライアント: ソケットエラー:', err);
  clearTimeout(timeoutId); // エラーが発生した場合もタイマーをクリア
});

client.on('close', () => {
  console.log('クライアント: 接続が閉じられました。');
  console.log(`クライアント: closeイベント後のreadyState: ${client.readyState}`); // 3 (CLOSED)
});

この例では、存在しないホストに接続を試みているため、接続が成功する可能性は低いです。setTimeout を使用して5秒後に readyState を確認し、もし 1 (OPEN) でなければ接続がタイムアウトしたと判断してソケットを破棄します。接続が成功した場合は、'connect' イベントでタイムアウトタイマーをクリアします。



イベント駆動型アプローチ

Node.jsのネットワーク関連APIは、ソケットの状態変化をイベントとして通知します。これらのイベントを適切に利用することで、readyState を直接監視することなく、ソケットの状態に応じた処理を記述できます。

  • 'error' イベント
    ソケットでエラーが発生したときに発生します。このイベントが発生すると、通常は 'close' イベントも続けて発生します。

    socket.on('error', (err) => {
      console.error('ソケットエラー:', err);
    });
    
  • 'close' イベント
    ソケットが完全に閉じられたときに発生します。このイベントが発生した時点で readyState3 (CLOSED) になっています。

    socket.on('close', (hadError) => {
      if (hadError) {
        console.error('ソケットはエラーにより閉じられました。');
      } else {
        console.log('ソケットは正常に閉じられました。');
      }
      // ソケットに関連するリソースのクリーンアップなど
    });
    
  • 'end' イベント
    ソケットの相手側がFINパケットを送信し、これ以上データが送信されないことを通知したときに発生します。このイベントが発生した時点で、ローカルソケットの readyState2 (CLOSING) に移行している可能性があります。

    socket.on('end', () => {
      console.log('相手側が接続を閉じました。');
      // これ以上データの受信は期待できません
    });
    
  • 'data' イベント
    ソケットがデータを受信したときに発生します。このイベントが発生している間は readyState1 (OPEN) であることが期待されます。

    socket.on('data', (data) => {
      console.log('受信データ:', data.toString());
    });
    
  • 'connect' イベント
    クライアントソケットがサーバーへの接続に成功したときに発生します。このイベントが発生した時点で readyState1 (OPEN) になっていることが期待されます。

    client.on('connect', () => {
      console.log('接続成功!');
      client.write('データの送信...\r\n');
    });
    

これらのイベントリスナーを適切に登録し、イベントハンドラー内で必要な処理を行うことで、ソケットの状態遷移をより自然に扱うことができます。

ストリームAPIの利用

net.Socket オブジェクトは Readable および Writable ストリームのインターフェースを実装しています。ストリームAPIを利用することで、データの読み書きをより抽象的に扱うことができます。

  • ストリームのイベント
    'data', 'end', 'error', 'finish' などのストリーム関連のイベントを利用して、データの流れや完了、エラーを監視できます。

    client.on('finish', () => {
      console.log('データ送信が完了しました。');
      client.end();
    });
    
  • pipe() メソッド
    Readableストリームからデータを読み取り、Writableストリームへ書き込む処理を簡潔に記述できます。ソケット間のデータ転送や、ファイルへの書き込みなどに利用できます。

    const fs = require('fs');
    const client = net.connect({ host: 'example.com', port: 80 });
    const fileStream = fs.createWriteStream('output.txt');
    
    client.pipe(fileStream); // サーバーからのレスポンスをファイルに書き込む
    

ストリームAPIを利用することで、低レベルなソケット操作の詳細を意識することなく、より高レベルなデータ処理に集中できます。

高レベルなライブラリの利用

HTTP、WebSocket、TLS/SSLなどの特定のプロトコルを扱う場合、Node.jsの標準モジュール (http, https, ws, tls) や、より高機能なサードパーティ製のライブラリを利用することで、ソケットの管理や状態遷移を意識する必要が少なくなる場合があります。

  • ws モジュール
    WebSocketサーバーやクライアントを簡単に実装できます。WebSocket接続の確立やメッセージの送受信などを高レベルなAPIで行えます。

    const WebSocket = require('ws');
    const ws = new WebSocket('ws://example.com');
    
    ws.on('open', () => {
      console.log('WebSocket接続が開きました。');
      ws.send('こんにちは!');
    });
    
    ws.on('message', (message) => {
      console.log('受信メッセージ:', message);
    });
    
    ws.on('close', () => {
      console.log('WebSocket接続が閉じられました。');
    });
    
  • http モジュール
    HTTPクライアントやサーバーを簡単に構築できます。リクエストの送信やレスポンスの受信、サーバーでのリクエスト処理などを高レベルなAPIで行えます。

    const http = require('http');
    http.get('http://example.com', (res) => {
      console.log('ステータスコード:', res.statusCode);
      res.on('data', (chunk) => {
        console.log('データ:', chunk.toString());
      });
    }).on('error', (err) => {
      console.error('HTTPリクエストエラー:', err);
    });
    

これらの高レベルなAPIやライブラリは、特定のプロトコルの複雑な処理を抽象化しており、開発者はアプリケーションのロジックに集中できます。内部的にはソケットの管理や状態遷移が行われていますが、直接 readyState を意識する必要は少なくなります。