This issue has been created
There are 2 updates.
 
 
JIRA Components / cid:jira-generated-image-avatar-1249d327-8d71-47c6-842c-09b9ac619b4f JIRA-125 Open

Display a user-friendly message when the JIRA server is unavailable

 
View issue   ยท   Add comment
 

Issue created

 
cid:jira-generated-image-avatar-c0bebf8d-5ac8-4921-8f1c-d6bbfd2c7b4a Vincent Massol created this issue on 06/Oct/26 10:43
 
Summary: Display a user-friendly message when the JIRA server is unavailable
Issue Type: cid:jira-generated-image-avatar-1249d327-8d71-47c6-842c-09b9ac619b4f Improvement
Affects Versions: 11.1.7
Assignee: Unassigned
Components: JIRA Macro
Created: 06/Oct/26 10:43
Priority: cid:jira-generated-image-static-major-0c7bc507-ea95-4221-aff8-b14f94163f8f Major
Reporter: Vincent Massol
Description:

When the JIRA server is unreachable or in maintenance (e.g. it answers with an HTTP 503 and an HTML maintenance page), the JIRA macro displays a raw technical error box to readers, including the full query URL:

Failed to execute the JIRA macro. Cause: [Error code = [503], Error message = [Unknown error] URL = [https://jira.xwiki.org/sr/jira.issueviews:searchrequest-xml/temp/SearchRequest.xml?jqlQuery=...]]. Click on this message for details.

This was seen on xwiki.org during a jira.xwiki.org maintenance, e.g. on https://www.xwiki.org/xwiki/bin/view/ReleaseNotes/Data/XWiki/18.4.4/ where every JIRA macro of the page displayed such a box (see screenshot).

Readers can't do anything about this error and it makes the page look broken. When the server can't be reached (connection failure, timeout) or answers with a 5xx status (in particular 502/503/504), the macro should instead display a short, translatable message, for example a warning box saying "The JIRA server (jira.xwiki.org) is currently unavailable. Please try again later.", and keep the technical details (status code, URL, stack trace) in the logs or in the collapsible details.

Other errors (invalid JQL, authentication or rights problems) should keep their precise error message.

noimage.png

 
 

2 updates

 
cid:jira-generated-image-avatar-c0bebf8d-5ac8-4921-8f1c-d6bbfd2c7b4a Changes by Vincent Massol on 06/Oct/26 10:43
 
Attachment: jira-down-errors.png
Assignee: