Node.js 非同期DNS処理：dns.resolveNaptr() の代替方法とエラーハンドリング

2025-05-16

NAPTR レコードは、DNS (Domain Name System) のリソースレコードの一種で、サービスの発見や電話番号のルーティングなど、さまざまな変換ルールを指定するために使用されます。具体的には、あるサービス名や抽象的な名前を、実際のサービスを提供するホスト名やプロトコル、ポート番号などに変換するルールを記述します。

関数の基本的な使い方

const dns = require('node:dns').promises;

async function resolveNaptrRecord(hostname) {
  try {
    const records = await dns.resolveNaptr(hostname);
    console.log(`NAPTR レコード (${hostname}):`, records);
  } catch (err) {
    console.error(`NAPTR レコードの解決に失敗しました (${hostname}):`, err);
  }
}

// NAPTR レコードを解決したいドメイン名を指定します
const domainToResolve = 'example.com'; // 実際の NAPTR レコードが存在するドメインに置き換えてください

resolveNaptrRecord(domainToResolve);

解説

const dns = require('node:dns').promises;: dns モジュールをインポートし、Promise ベースの API を利用できるようにしています。これにより、async/await 構文を使って非同期処理をより簡潔に記述できます。
async function resolveNaptrRecord(hostname) { ... }: NAPTR レコードの解決を行う非同期関数を定義しています。引数 hostname は、NAPTR レコードを検索したいドメイン名です。
const records = await dns.resolveNaptr(hostname);: dns.resolveNaptr() 関数を await キーワードを使って呼び出しています。この関数は、指定された hostname に対して NAPTR レコードの解決を試み、成功した場合は NAPTR レコードの配列を Promise の解決値として返します。失敗した場合はエラーをスローします。
console.log(...): 解決された NAPTR レコードの配列をコンソールに出力します。各 NAPTR レコードは、優先順位 (order)、重み (preference)、フラグ (flags)、サービス (service)、正規表現 (regexp)、置換 (replacement) などの情報を含むオブジェクトとして表現されます。
catch (err) { ... }: NAPTR レコードの解決に失敗した場合のエラー処理を行います。エラーの内容をコンソールに出力します。

NAPTR レコードの構造

dns.resolveNaptr() が返す NAPTR レコードの配列の各要素は、以下のようなプロパティを持つオブジェクトです。

preference: 同じ order を持つレコード内での選択の重み。値が小さいほど優先度が高いです。
order: 複数の NAPTR レコードが存在する場合の処理順序。値が小さいほど優先度が高いです。
replacement: 正規表現にマッチした場合の置換文字列。次の DNS ルックアップのドメイン名となることがあります。
regexp: 置換を行うための正規表現。
service: 利用可能なサービスの名前。例えば、"SIP+D2U" は SIP over UDP を示します。
flags: NAPTR レコードのフラグ。例えば、"s" はこのレコードが最終的なサービスを提供することを示し、"a" は次のルックアップが A レコードであることを示します。

利用シーン

NAPTR レコードは、例えば以下のようなシナリオで利用されます。

サービス指向アーキテクチャ (SOA): 特定のサービスを提供するエンドポイントを動的に発見する。
ENUM (E.164 Number Mapping): 電話番号をインターネットドメイン名に変換し、関連するサービスを発見する。
VoIP (Voice over IP) サービスの発見: 電話番号から対応する SIP URI を見つける。

注意点

NAPTR レコードの利用は、一般的な Web サイトの解決などではあまり一般的ではありません。特定のサービスやプロトコルに関連する高度な DNS 設定で利用されます。
指定したドメイン名に NAPTR レコードが存在しない場合、dns.resolveNaptr() はエラーを返します。

一般的なエラー

Error: queryA ENOTFOUND <hostname> / Error: queryAAAA ENOTFOUND <hostname>:
- 原因: 指定された hostname に対応する A レコード（IPv4 アドレス）または AAAA レコード（IPv6 アドレス）が見つからなかった場合に発生します。NAPTR レコードの解決プロセスで、最終的に A レコードや AAAA レコードを検索しようとした際に失敗することがあります。
- トラブルシューティング:
  - 指定したホスト名が正しいかどうか再度確認してください。
  - そのホスト名が DNS に登録されているか (dig コマンドや nslookup コマンドなどで) 確認してください。
  - ネットワーク接続に問題がないか確認してください。DNS サーバーに到達できる必要があります。
  - ファイアウォールが DNS (通常は UDP/TCP ポート 53) の通信をブロックしていないか確認してください。
Error: queryNAPTR ENODATA <hostname>:
- 原因: 指定された hostname に対して NAPTR レコードが存在しない場合に発生します。DNS サーバーはクエリを受け付けましたが、NAPTR レコードが見つからなかったことを示しています。
- トラブルシューティング:
  - 指定したホスト名に本当に NAPTR レコードが設定されているか (dig -t NAPTR <hostname> コマンドなどで) DNS サーバーに問い合わせて確認してください。
  - NAPTR レコードが最近追加された場合は、DNS キャッシュの影響を受けていないか確認してください。必要であれば、DNS キャッシュをクリアしてみてください。
  - 問い合わせる DNS サーバーが NAPTR レコードをサポートしているか確認してください（通常はサポートされています）。
Error: getaddrinfo ENOTFOUND <hostname>:
- 原因: dns.resolveNaptr() に渡された hostname が不正な形式であるか、DNS サーバーによって解決できない場合に発生します。これは、NAPTR レコードの検索を開始する前の基本的な名前解決の段階で失敗していることを示唆している場合があります。
- トラブルシューティング:
  - 指定したホスト名のスペルミスや形式が正しいか確認してください。
  - ネットワーク接続と DNS サーバーへの到達可能性を確認してください。
TypeError: Cannot read properties of undefined (reading '...'):
- 原因: dns.resolveNaptr() が Promise を返さない古いバージョンの Node.js を使用している場合に、await を使用すると発生することがあります。
- トラブルシューティング:
  - Node.js のバージョンが 8.0.0 以降であることを確認してください。Promise ベースの API はそれ以降で導入されました。
  - 古いバージョンを使用している場合は、コールバックベースの API (dns.resolveNaptr(hostname, callback)) を使用するか、Node.js をアップグレードすることを検討してください。
タイムアウトエラー:
- 原因: DNS サーバーからの応答が指定された時間内に返ってこない場合に発生することがあります。ネットワークの遅延や DNS サーバーの負荷が高いなどが原因として考えられます。
- トラブルシューティング:
  - ネットワーク接続の状態を確認してください。
  - 別の DNS サーバーを試してみることを検討してください（例: Google Public DNS (8.8.8.8, 8.8.4.4) や Cloudflare DNS (1.1.1.1, 1.0.0.1)）。
  - アプリケーションのタイムアウト設定を見直してください（Node.js の dns モジュール自体にはタイムアウト設定はありませんが、上位のネットワーク処理でタイムアウトが発生する可能性があります）。

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

エラーメッセージを注意深く読む: エラーメッセージは、問題の原因を特定するための重要な情報を提供してくれます。エラーの種類と関連するホスト名を正確に把握しましょう。
DNS ツールを使用する: dig や nslookup などのコマンドラインツールを使用して、DNS サーバーに直接クエリを送信し、NAPTR レコードの存在や内容、および他の関連レコード（A、AAAA など）を確認します。これにより、Node.js の問題なのか、DNS サーバー自体の問題なのかを切り分けることができます。
```
dig -t NAPTR <hostname>
dig <hostname>
nslookup -type=NAPTR <hostname>
nslookup <hostname>
```
ネットワーク接続を確認する: ping コマンドなどで DNS サーバーに到達できるか確認します。ファイアウォールが DNS の通信をブロックしていないかも確認してください。
DNS サーバーを変更してみる: 現在使用している DNS サーバーに問題がある可能性があるため、一時的に別のパブリック DNS サーバー（上記参照）を使用してみることで、問題が DNS サーバーに起因するかどうかを判断できます。
Node.js のバージョンを確認する: 古いバージョンの Node.js を使用している場合、API の動作が異なる可能性があります。最新の安定版にアップデートすることを検討してください。
コードの再確認: dns.resolveNaptr() に渡しているホスト名が正しいか、周辺のコードに論理的な誤りがないかなどを確認してください。
ログ出力を増やす: エラーが発生した際に、より多くの情報が得られるようにログ出力を追加することを検討してください。

基本的な NAPTR レコードの解決

これは、指定されたドメイン名の NAPTR レコードを取得し、その結果をコンソールに出力する基本的な例です。

const dns = require('node:dns').promises;

async function resolveNaptrExampleBasic(hostname) {
  try {
    const records = await dns.resolveNaptr(hostname);
    console.log(`NAPTR レコード (${hostname}):`, records);
  } catch (err) {
    console.error(`NAPTR レコードの解決に失敗しました (${hostname}):`, err);
  }
}

// NAPTR レコードが存在する可能性のあるドメインを指定してください
const targetDomainBasic = 'example.com'; // 実際のドメインに置き換えてください

resolveNaptrExampleBasic(targetDomainBasic);

解説

try...catch ブロックでエラーハンドリングを行っています。NAPTR レコードが見つからない場合など、エラーが発生する可能性があります。
dns.resolveNaptr(hostname) は、指定された hostname の NAPTR レコードを解決し、成功した場合はレコードの配列を返します。
resolveNaptrExampleBasic 関数は、async/await を使用して非同期処理を行っています。
require('node:dns').promises; で dns モジュールの Promise ベースの API をインポートしています。

解決された NAPTR レコードの情報を個別に処理する

この例では、解決された NAPTR レコードの配列をループ処理し、各レコードのプロパティ（order, preference, flags, service, regexp, replacement）を個別にコンソールに出力します。

const dns = require('node:dns').promises;

async function processNaptrRecords(hostname) {
  try {
    const records = await dns.resolveNaptr(hostname);
    if (records.length > 0) {
      console.log(`NAPTR レコード (${hostname}):`);
      records.forEach((record, index) => {
        console.log(`  レコード #${index + 1}:`);
        console.log(`    Order:       ${record.order}`);
        console.log(`    Preference:  ${record.preference}`);
        console.log(`    Flags:       ${record.flags}`);
        console.log(`    Service:     ${record.service}`);
        console.log(`    Regexp:      ${record.regexp}`);
        console.log(`    Replacement: ${record.replacement}`);
      });
    } else {
      console.log(`NAPTR レコードは見つかりませんでした (${hostname})`);
    }
  } catch (err) {
    console.error(`NAPTR レコードの解決に失敗しました (${hostname}):`, err);
  }
}

// NAPTR レコードが存在する可能性のあるドメインを指定してください
const targetDomainProcess = 'example.com'; // 実際のドメインに置き換えてください

processNaptrRecords(targetDomainProcess);

解説

レコードが見つからなかった場合のメッセージも出力しています。
各レコードのプロパティを分かりやすくコンソールに出力しています。
解決された NAPTR レコードの配列が存在する場合、forEach ループを使って各レコードを処理します。

特定の条件に合致する NAPTR レコードを検索する

この例では、解決された NAPTR レコードの中から、特定の service タイプを持つレコードをフィルタリングして処理します。

const dns = require('node:dns').promises;

async function findSpecificNaptrService(hostname, targetService) {
  try {
    const records = await dns.resolveNaptr(hostname);
    const matchingRecords = records.filter(record => record.service === targetService);

    if (matchingRecords.length > 0) {
      console.log(`サービス "${targetService}" に一致する NAPTR レコード (${hostname}):`);
      matchingRecords.forEach((record, index) => {
        console.log(`  レコード #${index + 1}:`, record);
      });
    } else {
      console.log(`サービス "${targetService}" に一致する NAPTR レコードは見つかりませんでした (${hostname})`);
    }
  } catch (err) {
    console.error(`NAPTR レコードの解決に失敗しました (${hostname}):`, err);
  }
}

// NAPTR レコードが存在する可能性のあるドメインと検索したいサービスタイプを指定してください
const targetDomainSpecific = 'example.com'; // 実際のドメインに置き換えてください
const serviceToFind = 'SIP+D2U'; // 検索したいサービスタイプ（例）

findSpecificNaptrService(targetDomainSpecific, serviceToFind);

解説

一致するレコードが見つかった場合、それらを出力します。
filter メソッドを使用して、record.service プロパティが targetService と一致するレコードのみを抽出しています。

エラーハンドリングのみを行う例

この例は、NAPTR レコードの解決を試み、エラーが発生した場合にのみエラーメッセージをコンソールに出力します。成功した場合は何も出力しません。

const dns = require('node:dns').promises;

async function resolveNaptrWithErrorHandling(hostname) {
  try {
    await dns.resolveNaptr(hostname);
    console.log(`NAPTR レコードの解決に成功しました (${hostname})`);
  } catch (err) {
    console.error(`NAPTR レコードの解決に失敗しました (${hostname}):`, err);
    console.error(`エラー詳細:`, err);
  }
}

// NAPTR レコードが存在しない可能性のあるドメインを指定してください
const targetDomainError = 'invalid-domain-with-no-naptr.example'; // 存在しない可能性のあるドメイン

resolveNaptrWithErrorHandling(targetDomainError);

成功した場合のメッセージも出力するようにしています。
try...catch ブロックを使用して、エラーが発生した場合にエラーメッセージとエラーの詳細を出力します。

コールバックベースの API を使用する (dns.resolveNaptr(hostname, callback))

Promise ベースの API (dns.promises.resolveNaptr) が導入される以前から、Node.js の dns モジュールはコールバックベースの API を提供していました。現在でも利用可能であり、async/await を使用しない場合に選択肢となります。

const dns = require('node:dns');

function resolveNaptrCallback(hostname) {
  dns.resolveNaptr(hostname, (err, records) => {
    if (err) {
      console.error(`NAPTR レコードの解決に失敗しました (${hostname}):`, err);
      return;
    }
    console.log(`NAPTR レコード (${hostname}):`, records);
  });
}

// NAPTR レコードを解決したいドメイン名を指定します
const targetDomainCallback = 'example.com'; // 実際のドメインに置き換えてください

resolveNaptrCallback(targetDomainCallback);

解説

コールバックベースの処理は、非同期処理の結果を扱うためにネストが深くなることがある点に注意が必要です（コールバック地獄）。
エラーが発生した場合は err オブジェクトが truthy な値となり、成功した場合は records に結果が含まれます。
コールバック関数は、エラーオブジェクト (err) と解決された NAPTR レコードの配列 (records) を引数として受け取ります。
dns.resolveNaptr(hostname, callback) 関数を呼び出し、ホスト名とコールバック関数を引数として渡します。

他の DNS 解決ライブラリを使用する

Node.js の標準 dns モジュール以外にも、より柔軟な機能や異なる API を提供するサードパーティの DNS 解決ライブラリが存在します。これらのライブラリは、NAPTR レコードの解決もサポートしている可能性があります。

native-dns: より低レベルの DNS プロトコルを扱うためのライブラリで、より詳細な制御が可能です。NAPTR レコードのクエリを自分で構築することもできます。
dns-lookup: シンプルな DNS ルックアップライブラリで、A、AAAA、MX、TXT などのレコードタイプに対応しています。NAPTR レコードのサポートは確認が必要です。

これらのライブラリの使い方はそれぞれ異なるため、各ライブラリのドキュメントを参照する必要があります。

例 (dns-lookup を使用する場合 - NAPTR サポートは要確認)

// npm install dns-lookup
const dnsLookup = require('dns-lookup');

async function resolveNaptrAlternative(hostname) {
  try {
    const result = await dnsLookup.resolve(hostname, 'NAPTR'); // 'NAPTR' タイプがサポートされているか確認が必要
    console.log(`NAPTR レコード (${hostname}):`, result);
  } catch (err) {
    console.error(`NAPTR レコードの解決に失敗しました (${hostname}):`, err);
  }
}

const targetDomainAlt = 'example.com'; // 実際のドメインに置き換えてください

// resolveNaptrAlternative(targetDomainAlt); // コメントアウト - NAPTR サポートを確認してください

注意
dns-lookup が NAPTR レコードを直接サポートしているかは、現時点では明確ではありません。使用前にライブラリのドキュメントを確認してください。native-dns の場合は、より複雑な実装が必要になる可能性があります。

DNS サーバーに直接クエリを送信する (より高度な方法)

より低レベルな制御が必要な場合や、標準の dns モジュールやサードパーティライブラリで提供されていない高度な機能を利用したい場合は、UDP や TCP を使用して DNS サーバーに直接 DNS クエリを送信し、レスポンスを解析する方法も考えられます。

この方法は、DNS プロトコルの深い理解と、自分でクエリとレスポンスのパケットを構築・解析する実装が必要となるため、高度な知識と手間がかかります。通常は、標準モジュールやライブラリの利用が推奨されます。

低レベルな操作: DNS プロトコルを深く理解し、細かく制御したい場合は、直接 DNS クエリを送信する方法がありますが、実装は複雑になります。
より高度な機能や制御: 標準モジュールで提供されていない機能が必要な場合は、サードパーティの DNS ライブラリを検討する価値があります。ただし、導入と学習のコストがかかる場合があります。
コールバック: async/await を使用できない場合や、コールバックベースの処理に慣れている場合は、dns.resolveNaptr(hostname, callback) を使用できます。
シンプルさ: async/await を使用できる環境であれば、dns.promises.resolveNaptr() が最も簡潔で推奨される方法です。

Node.js dnsモジュール解説：lookupService() の引数とコールバック

callback (Function): 非同期処理が完了した後に呼び出されるコールバック関数です。このコールバック関数は3つの引数を受け取ります。 err (Error | null): エラーが発生した場合、エラーオブジェクトが渡されます。成功した場合は null が渡されます。 hostname (string): IPアドレスに対応するホスト名です。逆引きに失敗した場合や情報がない場合は、IPアドレスがそのまま返されることがあります。 service (string): ポート番号に対応するサービス名です。例えば、ポート 80 なら 'http'、ポート 443 なら 'https' のような文字列が返されます。サービス名が特定できない場合は、ポート番号が文字列として返されることがあります。