Fix avatar change issues in Jira Data Center

プラットフォームについて: Data Center のみ。 - This article only applies to Atlassian apps on the Data Center プラットフォーム

この KB は Data Center バージョンの製品用に作成されています。Data Center 固有ではない機能の Data Center KB は、製品のサーバー バージョンでも動作する可能性はありますが、テストは行われていません。 Server* 製品のサポートは 2024 年 2 月 15 日に終了しました。Server 製品を実行している場合は、 アトラシアン Server サポート終了 のお知らせにアクセスして、移行オプションを確認してください。

*Fisheye および Crucible は除く

要約

Users are unable to change their avatars and receive the error message

"Error occurred while creating avatar, please contact your Jira administrators".

環境

Jira Data Center all versions

診断

  • When attempting to upload an image for a user avatar from the user profile page, clicking on confirm results in the error message: "Error occurred while creating avatar, please contact your Jira administrators".

    Avatar creation page displays the "Error occurred while creating avatar, please contact your Jira administrators" in red.
  • The following error can be found in the atlassian-jira.log:

url: /j9170/rest/api/latest/user/avatar; user: admin ERROR admin 843x197x1 ol4mxd 0:0:0:0:0:0:0:1 /rest/api/latest/user/avatar [c.a.jira.avatar.AvatarPickerHelperImpl] Unable to create avatar. java.nio.file.FileAlreadyExistsException: /Users/test/jira-home/atlassian-jira-software-9.17.0/data/avatars
url: /j9170/rest/api/latest/user/avatar; user: admin ERROR admin 843x197x1 ol4mxd 0:0:0:0:0:0:0:1 /rest/api/latest/user/avatar [c.a.j.rest.exception.ExceptionInterceptor] Returning internal server error in response java.lang.reflect.InvocationTargetException Caused by: com.atlassian.jira.rest.v2.issue.RESTException(Internal Server Error) at com.atlassian.jira.rest.v2.issue.AvatarResourceHelper.throwWebException(AvatarResourceHelper.java:445)
  • Use the directory listing for the "avatars" directory in <Jira_Home>/data, to check if the directory is a symbolic link.

Related Information

If you see no error message on the profile page, but the avatar reverts back to the previous image, please refer to Unable to Upload User Avatar

原因

Jira needs the avatars directory to be a real folder, not a shortcut. When you upload an avatar, Jira tries to create a new folder at that spot. If there's already a shortcut there, you'll get a FileAlreadyExistsException error.

ソリューション

  1. Jira を停止します。

  2. Back up the /avatars directory located in the Jira home.

  3. Remove the symbolic link.

  4. Jira を起動します。

更新日時: July 3, 2025

さらにヘルプが必要ですか?

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