flowable/flowable-engine · error · FlowableException

Error creating attachment response

Error message

Error creating attachment response

What it means

Wrapping FlowableException raised when anything in the binary-attachment creation path fails: reading the uploaded file's InputStream, taskService.createAttachment persisting it, or building the REST response. It is a checked catch-all that preserves the original cause.

Solutions

1. Inspect the wrapped cause exception in the response/log for the real failure
2. Verify database and content-store connectivity and configuration
3. Ensure no filter consumes the multipart stream before the resource reads it
4. Retry with a smaller file to rule out size/storage limits

try { const resp = await api.createBinaryAttachment(taskId, formData); return resp; } catch (e) { log.error('Attachment creation failed: ' + (e.cause || e.message)); throw e; }

When it happens

Trigger: POST creating a binary task attachment where file.getInputStream() throws (part already consumed/corrupt), the underlying persistence fails, or restResponseFactory.createAttachmentResponse throws.

Common situations: Uploaded part stream already consumed by an earlier filter; database connectivity problems; content store (filesystem/DB blob) misconfiguration; extremely large uploads exceeding storage limits.

Related errors

• Error creating attachment data
• Attachment content is required.
• Attachment with id ' ' does not have content associated…
• Could not process multipart content
• Error converting resource stream

AI-assisted analysis of flowable/flowable-engine@d6d39ce1c6 (2026-09-11). Data as JSON: /api/errors/fc39afbcfdd1dcca. Report an issue: GitHub.

Appendix: source

Thrown at modules/flowable-rest/src/main/java/org/flowable/rest/service/api/runtime/task/TaskAttachmentCollectionResource.java:180

        }

        if (request.getFileMap().size() == 0) {
            throw new FlowableIllegalArgumentException("Attachment content is required.");
        }

        MultipartFile file = request.getFileMap().values().iterator().next();

        if (file == null) {
            throw new FlowableIllegalArgumentException("Attachment content is required.");
        }

        try {
            Attachment createdAttachment = taskService.createAttachment(type, task.getId(), task.getProcessInstanceId(), name, description, file.getInputStream());

            return restResponseFactory.createAttachmentResponse(createdAttachment);

        } catch (Exception e) {
            throw new FlowableException("Error creating attachment response", e);
        }
    }
}

View on GitHub (pinned to d6d39ce1c6)