ankidroid/Anki-Android

The message "An error occurred when generating an image occlusion note" is sometimes shown when clicking the check button in the Image Occlusion editor

Open

#19678 opened on Dec 3, 2025

View on GitHub
 (9 comments) (0 reactions) (0 assignees)Kotlin (11,132 stars) (2,789 forks)batch import
Help WantedReproducedupstream-issue

Description

Checked for duplicates?

  • This issue is not a duplicate

Does it also happen in the desktop version?

  • This bug does not occur in the latest version of Anki Desktop

What are the steps to reproduce this bug?

In the first video below, I added an occlusion to an existing Image Occlusion note. When pressing the "Save" button, the message "2 cards updated" was shown. This is expected behavior.

In the second video below, I opened the Image Occlusion editor and didn't make any changes. I repeated this multiple times to show that sometimes the message "2 cards updated" was shown and sometimes the message "An error occurred when generating an image occlusion note".

  • Time number 1: "2 cards updated"
  • Time number 2: "2 cards updated"
  • Time number 3: "An error occurred when generating an image occlusion note"
  • Time number 4: "2 cards updated"
  • Time number 5: "2 cards updated"
  • Time number 6: "An error occurred when generating an image occlusion note"
  • Time number 7: "An error occurred when generating an image occlusion note"
  • Time number 8: "An error occurred when generating an image occlusion note"
  • Time number 9: "An error occurred when generating an image occlusion note"

https://github.com/user-attachments/assets/08c3e219-e0f4-496f-974f-9733004896c0

https://github.com/user-attachments/assets/df3182a3-4a01-4705-ae3b-3a47d3ebc756

I only got the message "An error occurred when generating an image occlusion note" when I didn't make changes in the Image Occlusion editor. That is, I didn't get that message after having made some changes in the Image Occlusion editor, so I can't confirm that it actually means that the changes that were done in the Image Occlusion editor were not saved.

Even if the changes are saved when that message is shown, I believe that it shouldn't be shown in the first place because it might lead to some users think that the changes that they did in the Image Occlusion editor were not saved, which could ultimately cause her/him to waste some time going through their notes to confirm that the changes were actually saved.

Expected behaviour

The message "An error occurred when generating an image occlusion note" shouldn't be shown when no changes were done in the Image Occlusion editor.

Debug info

AnkiDroid Version = 2.23.0beta4 (367917ada802088c982a8ce11312fbb35d4290c3)  
Backend Version = 0.1.62-anki25.09.2 (25.09.2 3890e12c9e48c028c3f12aa58cb64bd9f8895e30)  
Android Version = 15 (SDK 35)  
ProductFlavor = full  
Device Info = samsung | samsung | gta4xlswifi | gta4xlswifixx | SM-P620 | s5e8825  
Webview User Agent = Mozilla/5.0 (Linux; Android 15; SM-P620 Build/AP3A.240905.015.A2; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/142.0.7444.102 Safari/537.36  
ACRA UUID = a32527bb-1a56-4c2f-92a8-65ce53ea03ff  
FSRS = 5.1.0 (Enabled: false)  
Crash Reports Enabled = true

(Optional) Anything else you want to share?

No response

Research

  • I have checked the manual and the FAQ and could not find a solution to my issue
  • (Optional) I have confirmed the issue is not resolved in the latest alpha release (instructions)

Contributor guide

Tech stack
kotlinandroid
Domain
mobile
Issue type
bug
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
3
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-3 hours
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
active
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
clear
Prerequisites
Android developmentKotlinFamiliarity with AnkiDroid codebase
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
60
Research direction
Investigate the Image Occlusion editor's save/check logic. Search for the error message 'An error occurred when generating an image occlusion note' in the codebase to locate the relevant handler. Examine the condition that triggers this error and why it may fire when no changes are made. Pay attention to state management and potential race conditions. Review the commit history or any recent changes related to image occlusion. Check the videos attached to reproduce the sporadic behavior.