FTP Connector のトラブルシューティング - Mule 4

FTP 用 Anypoint Connector (FTP Connector) をトラブルシューティングするには、Mule アプリケーションの問題のトラブルシューティングに関する情報を理解しておきます。

Mule アプリケーションの問題のトラブルシューティング

場合によって、アプリケーションが失敗している理由がわからず、アプリケーションの FTP サーバーとのやりとりで何が行われているかについて理解を深める必要があることがあります。

このエラーを解決する手順は、次のとおりです。

  • 設定ファイルを使用して、サーバー側のログレベルを引き上げます。

  • たとえば Cyberduck や Filezilla などの FTP クライアントを使用して、問題の再現を試みます。これらのクライアントを使用した場合でも問題が発生する場合は、問題が Mule アプリケーションには関連していない可能性が高くなります。

  • FTP Connector および JSCH ドライバーの冗長ログを有効にして、Mule アプリケーション側に関するより分かりやすく詳細なログを取得します。

    1. Anypoint Studio にアクセスし、​[Package Explorer]​ ビューに移動します。

    2. アプリケーションのプロジェクト名を開きます。

    3. src/main/resources​ パスフォルダーを開きます。

    4. フォルダー内の ​log4j2.xml​ ファイルを開きます。

    5. 次の行がすでに ​log4j2.xml​ ファイル内にある場合は、そのコメントを解除して有効にします。それ以外の場合、次の行を追加します。

          <AsyncLogger name="org.mule.extension.ftp" level="TRACE"/>
          <AsyncLogger name="org.apache.commons.net" level="DEBUG"/>
      xml
    6. 次の引数を追加して設定を実行します。

      ​`-M-Djavax.net.debug=ssl,handshake`
  • アプリケーションを可能な限り単純にして問題がアプリケーションと FTP サーバー間のやりとりに関係しているかどうかを判断できるように、不要な DataWeave データ変換は最小限に抑えるか削除してみてください (ハードコードされたデータを使用することもできます)。

Mule アプリケーションで SDK コンポーネントの冗長ログを有効にする方法についての詳細は、​「SDK コンポーネントおよび操作のトラブルシューティング」​ドキュメントを参照してください。

一般的なスローを理解する

次に、一般的なスローメッセージとその解釈方法のリストを示します。

  • FTP:ACCESS_DENIED

FTP Connector の操作が FTP サーバーパスへのアクセスを試み、ユーザーに権限のないアクションを実行しました。

  • FTP:CONNECTIVITY

FTP サーバーへの接続が中断されました。

  • FTP:FILE_ALREADY_EXISTS

既存のファイルと同じ場所と名前でファイルを作成しようとしました。

  • FTP:FILE_LOCK

ファイルをロックしようとしましたが失敗しました。

  • FTP:ILLEGAL_CONTENT

Write​ 操作で書き込み対象として無効なコンテンツを受信しました。

  • FTP:ILLEGAL_PATH

指定されたパスが無効です (存在しないなど)。

  • FTP:RETRY_EXHAUSTED

実行ブロックの再試行回数に達しました。