---
schema_version: "1"
id: a64442fd854dd6b8fc4ca20a0709c65d66ddc4bcac62b2516aac3c4859c06fe7
title: SFTP Connector のトラブルシューティング
collection: mulesoft
version: current
locale: ja-jp
portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/sftp-connector/2.3/sftp-connector-troubleshooting.md
canonical_url: https://docs.mulesoft.com/jp/sftp-connector/2.3/sftp-connector-troubleshooting
source_site: docs.mulesoft.com
content_type: documentation
content_hash: dbaee3b6f04d7a2281dc60fc2bd91683780796dc582e842686fde4d3c3876217
description: MuleSoft Documentation Site
release: "2.3"
latest: false
---
# SFTP Connector のトラブルシューティング

SFTP 用 Anypoint Connector (SFTP Connector) をトラブルシューティングするには、接続、権限、サーバー側の問題のトラブルシューティング、Mule アプリケーションの問題のトラブルシューティング、一般的なエラーメッセージの解釈に関する情報について理解しておいてください。

## [](#接続権限サーバー側の問題のトラブルシューティング)接続、権限、サーバー側の問題のトラブルシューティング

場合によって、SFTP サーバーへの接続を試みているときに、SFTP サーバーで設定済みの暗号化された通信チャネルが必要であるために接続の確立で問題が発生することがあります。 たとえば、特定の暗号化の暗号や鍵交換アルゴリズムを有効にするか、特定の認証鍵の場所を指定する必要があることもあります。

この問題を解決する手順は、次のとおりです。

1. SFTP サーバー設定ファイルを見つけ、接続、暗号化方法、タイムアウトなどに関するパラメーターや設定を確認します。必要に応じて設定を修正し、ニーズに合わせて環境をカスタマイズします。 たとえば、OpenSSH を使用している場合は ​`sshd_config`​ ファイルにアクセスできます。
2. 設定ファイルを使用して、サーバー側のログレベルを引き上げます。

## [](#mule-アプリケーションの問題のトラブルシューティング)Mule アプリケーションの問題のトラブルシューティング

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

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

- 設定ファイルを使用して、サーバー側のログレベルを引き上げます。
- たとえば Cyberduck や Filezilla などの SFTP クライアントを使用して、問題の再現を試みます。これらのクライアントを使用した場合でも問題が発生する場合は、問題が Mule アプリケーションには関連していない可能性が高くなります。
- SFTP Connector および Apache Mina ライブラリの冗長ログを有効にして、Mule アプリケーション側に関するより分かりやすく詳細なログを取得します。
    
    1. Anypoint Studio にアクセスし、​**\[Package Explorer\]**​ ビューに移動します。
    2. アプリケーションのプロジェクト名を開きます。
    3. `src/main/resources`​ パスフォルダーを開きます。
    4. フォルダー内の ​`log4j2.xml`​ ファイルを開きます。
    5. 次の行がすでに ​`log4j2.xml`​ ファイル内にある場合は、そのコメントを解除して有効にします。それ以外の場合、次の行を追加します。
        
        ```xml
            <AsyncLogger name=“org.mule.extension.sftp” level=“DEBUG”/>
            <AsyncLogger name=“org.apache.sshd” level=“TRACE”/>
        ```
    6. 次の引数を追加して設定を実行します。
        
        ​\`-M-Djavax.net.debug=ssl,handshake\`
    7. 相関 ID を子スレッドに確実に渡して SSH ログに表示するには、次の引数を実行設定に含めます。
        
        ​\`-Dlog4j2.isThreadContextMapInheritable=true\`
- アプリケーションを可能な限り単純にして問題がアプリケーションと SFTP サーバー間のやりとりに関係しているかどうかを判断できるように、不要な DataWeave データ変換は最小限に抑えるか削除してみてください (ハードコードされたデータを使用することもできます)。

Mule アプリケーションで SDK コンポーネントの冗長ログを有効にする方法についての詳細は、​[「SDK コンポーネントおよび操作のトラブルシューティング」](https://docs.mulesoft.com/mule-sdk/latest/troubleshooting)​ドキュメントを参照してください。

## [](#common-throws)一般的なスローを理解する

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

- SFTP:ILLEGAL\_PATH
    
    指定されたパスが無効です (存在しないなど)。
- SFTP:FILE\_ALREADY\_EXISTS
    
    既存のファイルと同じ場所、同じ名前でファイルを作成しようとしました。
    この問題は、たとえば ​CREATE\_NEW​ 書き込みモードを使用してすでに存在しているファイルのパスにファイルを書き込もうとした場合に発生します。
- SFTP:ACCESS\_DENIED
    
    SFTP サーバーパスにアクセスしてユーザーが権限を付与されていないアクションを実行しようとする操作が試行されました。
- SFTP:FILE\_LOCK
    
    ファイルに対するロックを取得しようとする操作が試行されましたが失敗しました。
- SFTP:ILLEGAL\_CONTENT
    
    ​\*Write\*​ 操作で書き込み対象として無効なコンテンツを受信しました。
- SFTP:CONNECTIVITY
    
    SFTP サーバーへの接続が中断されました。
- SFTP:INVALID\_CREDENTIALS
    
    無効なログイン情報が原因で SFTP サーバーに対する認証に失敗しました。
- SFTP:CONNECTION\_TIMEOUT
    
    SFTP サーバーへの接続試行がタイムアウトになりました。
- SFTP:CANNOT\_REACH
    
    指定された SFTP サーバーホストおよびポートへの接続を確立しようとしていてエラーが発生しました。通常、たとえばリモートアドレスまたはポートでリスンしているプロセスが存在しない場合、接続はリモートで拒否されます。
- SFTP:UNKNOWN\_HOST
    
    Mule ではホストの IP アドレスを判断できません。
- SFTP:DISCONNECTED
    
    アプリケーションでサーバーへのログイン試行の失敗回数が多すぎます。この問題の原因は複数考えられますが、最も一般的な原因は無効なログイン情報です。
- SFTP:KEY\_EXCHANGE\_FAILED
    
    アプリケーションはサーバーへの SSH 接続の確立を試みましたが、鍵交換ステップで失敗しました。ネゴシエーション中、または鍵交換の後半のステップでエラーが発生する場合があります。
- FILE\_DOESNT\_EXIST
    
    The file to write was deleted. (書き込むファイルが削除されています。)

## [](#関連情報)関連情報

- [SFTP Connector リファレンス](https://docs.mulesoft.com/jp/sftp-connector/2.3/sftp-documentation)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)
- [Known Issues](https://help.salesforce.com/s/issues)