After upgrading Jira all attachments got broken displaying a 404 error page

Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.

Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. 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.

*Except Fisheye and Crucible

Summary

After upgrading Jira, allattachments are broken bringing up a 404 error page.

A 404 error page is displayed when clicking on the attachments, instead of downloading or displaying them.

Environment

Jira Server / Data Center

Cause

The problem could be a custom modification in the web.xml file that was copied over to the newly upgraded web.xml file, or simply replacing the old web.xml file with the new one.

Solution

Restore the original web.xml file and add the additional changes to it, instead of replacing the whole web.xml file from the old to the new instance.

In case the additional changes continues to break the attachment, simply keep the original one and it should fix the issue.

Make sure to not copy over the old files to the new Jira version upgraded. This is because the native settings of these key files can change between the Jira versions. Due to this, our recommendation is always to re-apply the same modifications to the new files ( in case you have any ) by copying them from your backup, but, only copying the exact modification and not the whole file. According to Upgrading Jira it outlines the following:

While using Jira, you’ve probably added some custom modifications to Jira files. These may include connection details, settings related to memory allocation, or other JVM arguments. In this step, you need to re-apply the same modifications to the new files by copying them from your backups.

Make sure you don't just copy over the old files, as the 'native' settings they contain might have changed between the Jira versions.

Updated on April 8, 2025

Still need help?

The Atlassian Community is here for you.