--- schema_version: "1" id: 491bcebaf5813323bb705d11fba17a55a291370f64aee64a4cd58c0359fc47a9 title: Email Connector のトラブルシューティング collection: mulesoft version: current locale: ja-jp portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/email-connector/1.4/email-troubleshooting.md canonical_url: https://docs.mulesoft.com/jp/email-connector/1.4/email-troubleshooting source_site: docs.mulesoft.com content_type: documentation content_hash: 0098c2538dbb43a439efd7d5dedd002633bbd3792e1f768110edd5726e87350d description: MuleSoft Documentation Site release: "1.4" latest: false --- # Email Connector のトラブルシューティング メール用 Anypoint Connector (Email Connector) のトラブルシューティングを行うには、アプリケーションログ、JavaMail のデバッグ、添付ファイルへのアクセスのトラブルシューティング、プロトコルの問題のトラブルシューティング、一般的なメッセージの解釈に関する情報を理解しておいてください。 ## [](#アプリケーションログの表示)アプリケーションログの表示 Mule Runtime Engine (Mule) アプリケーションの実行中に問題が発生した場合は、次のようにアプリケーションログを参照してください。 - アプリケーションを Anypoint Platform から実行している場合、出力は Anypoint Studio のコンソールウィンドウに表示される。 - コマンドラインから Mule を使用してアプリケーションを実行している場合、アプリケーションログは OS コンソールに表示される。 アプリケーションのログファイル ​`log4j2.xml`​ でログファイルパスがカスタマイズされていない場合、デフォルトの場所 ​`MULE_HOME/logs/.log`​ でアプリケーションログを参照します。 ## [](#javamail-デバッグログを有効化する)JavaMail デバッグログを有効化する JavaMail デバッグログは、基盤となるサードパーティクラスで使用されます。 JavaMail デバッグログを有効化する手順は、次のとおりです。 1. Anypoint Studio にアクセスし、​**\[Package Explorer\]**​ ビューに移動します。 2. アプリケーションのプロジェクト名を開きます。 3. `src/main/mule`​ パスフォルダーを開きます。 4. フォルダー内の Mule アプリケーション XML ファイルを開きます。 5. ``​ を IMAP または SMTP 接続要素に追加します。 ```xml ``` 6. 変更を保存します。 7. **Package Explorer**​ でプロジェクト名をクリックし、​**\[Run (実行)\]**​ > ​**\[Run As (別のユーザーとして実行)\]**​ > ​**\[Mule Application (Mule アプリケーション)\]**​ をクリックします。 8. **\[Console (コンソール)\]**​ ビューに移動してロガー内のメールメッセージを読みます。 ```plain-text DEBUG: JavaMail version 1.6.3 DEBUG: successfully loaded resource: /META-INF/javamail.default.address.map DEBUG: getProvider() returning javax.mail.Provider[STORE,imap,com.sun.mail.imap.IMAPStore,Oracle] DEBUG IMAP: mail.imap.fetchsize: 16384 DEBUG IMAP: mail.imap.ignorebodystructuresize: false DEBUG IMAP: trying to connect to host "******", port 993, isSSL true * OK The Microsoft Exchange IMAP4 service is ready. [******] A0 CAPABILITY * CAPABILITY IMAP4 IMAP4rev1 AUTH=PLAIN AUTH=XOAUTH2 SASL-IR UIDPLUS MOVE ID UNSELECT CHILDREN IDLE NAMESPACE LITERAL+ A0 OK CAPABILITY completed. ... ``` アプリケーションを Anypoint Platform で実行している場合、ログではコンソールビューにデバッグ行が出力されます。 スタンドアロン Mule でアプリケーションを実行している場合、ログではログファイルにデバッグ行が出力されます。 ## [](#email-connector-デバッグログを有効化する)Email Connector デバッグログを有効化する Email Connector のトラブルシューティングを開始するには、正確なエラーメッセージを確認するためにデバッグログを有効にします。 1. Anypoint Studio にアクセスし、​**\[Package Explorer\]**​ ビューに移動します。 2. アプリケーションのプロジェクト名を開きます。 3. `src/main/resources`​ パスフォルダーを開きます。 4. フォルダー内の ​`log4j2.xml`​ ファイルを開きます。 5. 次の行がすでに ​`log4j2.xml`​ ファイル内にある場合は、そのコメントを解除して有効にします。それ以外の場合、次の行を追加します。 ```xml ``` 6. 変更を保存します。 7. **Package Explorer**​ でプロジェクト名をクリックし、​**\[Run (実行)\]**​ > ​**\[Run As (別のユーザーとして実行)\]**​ > ​**\[Mule Application (Mule アプリケーション)\]**​ をクリックします。 8. **\[Console (コンソール)\]**​ ビューに移動してロガー内の Email Connector のメッセージを読みます。 ```plain-text DEBUG 2021-04-26 18:51:08,536 [_pollingSource_imapattachmentFlow/executor.01] [processor: ; event: ] org.mule.extension.email.internal.mailbox.BaseMailboxPollingSource: Poll will be skipped, since last poll emails are still being processed INFO 2021-04-26 18:51:09,166 [[MuleRuntime].uber.04: [imapattachment].imapattachmentFlow.CPU_LITE @111719e0] [processor: imapattachmentFlow/processors/1/processors/2; event: 820f7fe0-a6d9-11eb-a84b-147dda4dba09] org.mule.runtime.core.internal.processor.LoggerMessageProcessor: "" as Binary {base: "64"} DEBUG 2021-04-26 18:51:15,360 [_pollingSource_imapattachmentFlow/executor.01] [processor: ; event: ] org.mule.extension.email.internal.mailbox.BaseMailboxPollingSource: Email [172] was not processed. .... ``` ## [](#smtps-と-gmail-の接続の問題のトラブルシューティング)SMTPS と Gmail の接続の問題のトラブルシューティング SMTPS 接続の問題のトラブルシューティングに使用する方法は、Gmail アカウントで 2 要素認証を使用しているかどうかによって異なります。 ### [](#2-要素認証)2 要素認証 アカウントで 2 要素認証値を使用している場合は、アプリケーション固有のパスワードを生成し、通常のパスワードの代わりにそのパスワードを使用します。 詳細は、 [「アプリパスワードでログインする」](https://support.google.com/accounts/answer/185833)​を参照してください。Gmail アカウントで​**安全性の低いアプリ**​を有効にする必要はありません。 ### [](#パスワードベースの認証)パスワードベースの認証 Gmail アカウントで 2 要素認証を使用していない場合は、Gmail アカウントで​**安全性の低いアプリ**​をセットアップして有効化します。パスワードが機能しない場合は、 [「Google アカウントへのアクセスを許可」](https://accounts.google.com/b/0/DisplayUnlockCaptcha)​に移動して、次の手順を実行します。 1. ユーザー名とパスワードを入力します。 2. Captcha 画面の文字を入力します。 3. Mule アプリケーションに戻り、フローを再実行します。 ## [](#さまざまなプロトコルの動作の理解)さまざまなプロトコルの動作の理解 問題がプロトコルの動作である場合は、RFC のドキュメントを確認してください。Request for Comments (RFC) とは、Internet Society (ISOC) およびその関連団体 (特に有名なのはインターネットの主要な技術開発および基準設定団体である Internet Engineering Task Force (IETF)) による公開文書です。IETF ではインターネット基準として RFC としてパブリッシュされた提案のいくつかを採用しています。 確認できるドキュメントの一部を紹介します。 - [RFC-5322 - インターネットメッセージの形式](https://tools.ietf.org/html/rfc5322) - [RFC-1064 - IMAP2 - Internet Message Access Protocol - バージョン 2](https://tools.ietf.org/html/rfc1064) - [RFC-1939 - POP3 - Post Office Protocol - バージョン 3](https://tools.ietf.org/html/rfc1939) - [RFC-5321 - SMTP - Simple Mail Transfer Protocol](https://tools.ietf.org/html/rfc5321) - [RFC-2045 - MIME - Multipurpose Internet Mail Extensions パート 1: インターネットメッセージ本文の形式](https://tools.ietf.org/html/rfc2045) ## [](#一般的なスローの理解)一般的なスローの理解 ここでは、一般的なスローメッセージとその解決方法を示します。 - EMAIL:EMAIL\_NOT\_FOUND The email identified by ​\`emailId\`​ cannot be found in a mailbox folder. (「emailId」で識別されるメールがメールボックスフォルダーに見つかりません。) - EMAIL:ACCESSING\_FOLDER There was a problem accessing an email folder or the folder does not exist. (メールフォルダーへのアクセスで問題が発生したか、フォルダーが存在しません。) - EMAIL:CONNECTIVITY A connection could not be established. (接続を確立できませんでした。) - EMAIL:RETRY\_EXHAUSTED A problem occurred during message routing. (メッセージルーティング中に問題が発生しました。) - EMAIL:EMAIL\_LIST An error occurred during an attempt to list emails. (メールのリスト作成試行中にエラーが発生しました。) - EMAIL:SEND An exception occurred during an attempt to send an email. (メールの送信試行中に例外が発生しました。) - EMAIL:FETCHING\_ATTRIBUTES An error occurred during email attribute parsing from an email. (メールからのメール属性の解析中にエラーが発生しました。) - EMAIL:MARK An error occurred during email flag marking. (メールフラグのマーク中にエラーが発生しました。) - EMAIL:EXPUNGE\_ERROR A error occurred during an attempt to delete emails from a folder. (フォルダーからのメールの削除試行中にエラーが発生しました。) - EMAIL:ATTACHMENT An error occurred during an attempt to send an attachment. (添付ファイルの送信試行中にエラーが発生しました。) - EMAIL:READ\_EMAIL An error occurred during an attempt to read the email content. (メールコンテンツの読み取り試行中にエラーが発生しました。) - EMAIL:AUTHENTICATION Authentication failed. (認証に失敗しました。) - EMAIL:INVALID\_CREDENTIALS An error occurred during the username and password parameter consistency check. (ユーザー名とパスワードパラメーターの一貫性チェック中にエラーが発生しました。) - EMAIL:UNKNOWN\_HOST The IP address of a host cannot be determined or a port is out of range. (ホストの IP アドレスを判断できないか、ポートが範囲外です。) - EMAIL:CONNECTION\_TIMEOUT The server took too long to reply to a data request. (サーバーでデータ要求への返信に時間がかかりすぎました。) - EMAIL:DISCONNECTED An error occurred during store connecting, or the connection was interrupted. (ストア接続中にエラーが発生したか、接続が中断されました。) - EMAIL:SSL\_ERROR An error occurred during SSL context creation, or the TLS context wasn't properly configured. (SSL コンテキスト作成中にエラーが発生したか、TLS コンテキストが適切に設定されませんでした。) ## [](#関連情報)関連情報 - [MuleSoft ヘルプセンター](https://help.mulesoft.com) - [Email Connector リファレンス](https://docs.mulesoft.com/jp/email-connector/1.4/email-documentation)