メインコンテンツまでスキップ
バージョン: 4.6.1-saas

トラブルシューティング

NetFUNNEL Node.js Agent統合に関する一般的な問題、解決方法、よくある質問です。

インストール問題​

パッケージインストール失敗​

症状:

  • npm installが失敗する
  • パッケージが見つからない

解決方法:

  1. パッケージパス確認: package.jsonの依存関係パスが正しいか確認
  2. コンソール確認: コンソールのエージェントタブで正確なURL確認
  3. ネットワーク接続確認: インターネット接続状態を確認
  4. npmキャッシュクリア: npm cache clean --forceを実行して再試行

初期化失敗​

症状:

  • サーバー起動時にエラー発生
  • NetFUNNELが初期化されない

解決方法:

  1. clientId確認: clientIdが正しく設定されているか確認
  2. secretKey確認: secretKeyが正しく設定されているか確認
  3. 空文字列確認: clientIdとsecretKeyが空文字列でないか確認
  4. 初期化位置: Expressの場合はapp.tsで、Nuxtの場合はミドルウェアで初期化しているか確認

ミドルウェア問題​

Expressミドルウェアが動作しない​

症状:

  • ミドルウェアが呼び出されない
  • NetFUNNELロジックが実行されない

解決方法:

  1. 登録確認: app.use(netfunnelMiddleware)が正しく呼び出されているか確認
  2. 順序確認: 他のミドルウェアより先に登録されているか確認
  3. 初期化確認: Netfunnel.initialize()がミドルウェア登録前に呼び出されているか確認
  4. パス確認: 特定のパスにのみ適用する場合はapp.use('/path', netfunnelMiddleware)を使用

Nuxtミドルウェアが動作しない​

症状:

  • ミドルウェアが呼び出されない
  • NetFUNNELロジックが実行されない

解決方法:

  1. ファイル位置確認: server/middleware/netfunnelAgent.tsにファイルが正しく配置されているか確認
  2. ファイル名確認: ファイル名が正しいか確認
  3. 初期化確認: ミドルウェア内でNetfunnel.initialize()が呼び出されているか確認

トリガールール問題​

トリガールールがマッチしない​

症状:

  • 待機列が適用されない
  • ルールに適合するURLでも待機室が表示されない

解決方法:

  1. ルール確認: コンソールでトリガールールが正しく設定されているか確認
  2. URL確認: アクセスしたURLがルールのValueと一致するか確認
  3. Matchオプション確認: Matchオプション(Equals、Contains、StartsWith、EndsWith)が正しいか確認
  4. 大文字小文字確認: Aaオプション(大文字小文字区別)設定確認
  5. テスト機能使用: コンソールのトリガールールテスト機能でURLがルールに適合するか確認

待機室が表示されない​

症状:

  • ルールに適合するURLでも待機室が表示されない
  • ユーザーが直接進行する

解決方法:

  1. セグメント有効化: セグメントが有効化されているか確認
  2. 進入状態確認: 進入状態がWaitingに設定されているか確認
  3. 進入許可数確認: テストのために進入許可数を0に設定
  4. ルールマッチング確認: トリガールールが正しくマッチしているか確認

ネットワークおよび接続問題​

ネットワーク接続エラー​

症状:

  • NetFUNNELサーバーに接続できない
  • リクエストが失敗する

解決方法:

  1. 接続確認: インターネット接続状態を確認
  2. ファイアウォール: NetFUNNELドメインがブロックされていないか確認
  3. プロキシ設定: 必要な場合プロキシ構成
  4. サーバーURL確認: serverUrl設定が正しいか確認

タイムアウトエラー​

症状:

  • リクエストがタイムアウトする
  • レスポンスを受信できない

解決方法:

  1. ネットワーク状態確認: ネットワーク接続状態を確認
  2. サーバー状態確認: NetFUNNELサーバー状態を確認
  3. 設定確認: 初期化設定が正しいか確認

ロギング問題​

ログが出力されない​

症状:

  • printLog: trueに設定したがログが出力されない

解決方法:

  1. 設定確認: printLog: trueが正しく設定されているか確認
  2. 初期化確認: Netfunnel.initialize()でprintLog: trueが設定されているか確認
  3. コンソール確認: サーバーコンソールでログを確認

キー管理問題​

キーが返却されない​

症状:

  • 次のユーザーが無期限に待機する
  • 待機列が進行しない

解決方法:

  1. returnKey設定確認: returnKey設定が正しいか確認
  2. タイムアウト確認: セグメントタイムアウト設定確認
  3. サーバーログ確認: サーバーログでキー返却関連エラー確認

デバッグのヒント​

ログ確認​

デバッグのためにprintLog: trueを設定してログを確認できます:

import { Netfunnel } from 'netfunnel-node-agent';

Netfunnel.initialize({
  clientId: '{{CLIENT_ID}}',
  secretKey: '{{SECRET_KEY}}',
  printLog: true  // デバッグログ有効化
});

バージョン確認​

エージェントバージョンを確認できます:

import { Netfunnel } from 'netfunnel-node-agent';

console.log('NetFUNNEL Version:', Netfunnel.getVersion());

一般的な確認事項​

  1. 初期化確認: Netfunnel.initialize()が正しく呼び出されているか確認
  2. ミドルウェア登録: Express/Nuxtミドルウェアが正しく登録されているか確認
  3. トリガールール: コンソールでトリガールールが正しく設定されているか確認
  4. 依存関係確認: netfunnel-node-agentパッケージが正しくインストールされているか確認

関連ドキュメント​