Troubleshooting Jira incoming mail handler issues


アトラシアン コミュニティをご利用ください。


プラットフォームについて: Server および Data Center のみ。この記事は、Server および Data Center プラットフォームのアトラシアン製品にのみ適用されます。

Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Fisheye および Crucible は除く


The purpose of this KB article is to provide some diagnostic steps that can be followed to troubleshoot issues with Jira Incoming Mail Handlers configured in ⚙ > System > Incoming Mail, such as:

  • New Jira issues are not created from incoming emails
  • Comments are not added to existing Jira issues from incoming emails


Begin with the initial assessment, and proceed to the advanced assessment if further diagnosis is required.


  1. メッセージがメール アカウントに到達しているかどうかを確認します。メール サーバーの管理者に、Jira アプリケーションのアカウントに送信されたメールがアカウントの受信箱に正常に到達しているかどうかの確認を依頼してください。
  2. Jira アプリケーションで Create Or Comment Handler サービスが適切に構成されているかどうかを確認します。これを評価するには「メールから課題やコメントを作成する」をご確認ください。
  3. 権限が適切に設定されていることを確認します。課題を登録しているユーザーに、権限スキームの課題の作成権限は割り当てられていますか? コメントの追加で問題が起きている場合、課題セキュリティ スキームによって課題へのユーザー アクセスが制限されていないことを確認します。


  1. Jira アプリケーションでデバッグ ログを有効化します。
    1. ロギングとプロファイリング」に移動します。
    2. トラブルシューティングの対象に応じ、受信または送信メールのログについて [有効化] と [デバッグの有効化] をクリックします。
      1. 代替方法: これらのオプションが提供されていない場合、packages com.atlassian.mail (送信) や com.atlassian.mail.incoming (受信) のログ パッケージについて DEBUG レベルを追加します。
  2. Send two e-mails to the email address that your JIRA application is checking for new issues and comments. Wait 5 minutes and then submit a support request that includes the JIRA application logs. This can be done from the following menu:
    Administration -> System -> Services

    Service Info の例

    handler: Create Or Comment Handler
    popserver: POP server - JSP
    handler.params: project=JSP, issuetype=1, createusers=true, stripquotes=true, bulk=forward
    usessl: No SSL

     Attach JIRA application logs ボックスを確認するようにしてください。また、テストに利用されているメール アドレスを含め、この Create Or Comment ハンドラの Jira アプリケーション サービス設定をコピー/ペーストしてください。

  3. ロギングとプロファイリングでメールのデバッグ レベルのロギングを無効化します。

    a. 代替方法を利用している場合、ログ パッケージを再度追加して WARN に設定します。



Common Causes for mail and mail handlers issues

Expand the titles below to see the common causes for mail and mail handler issues:

Check known Mail and Mail Handlers issues from our Knowledge Base

最終更新日 2023 年 5 月 24 日




Powered by Confluence and Scroll Viewport.