alibaba/nacos · error · IllegalArgumentException

Invalid contentDigest

Error message

Invalid contentDigest: {contentDigest}

What it means

Error "Invalid contentDigest: {contentDigest}" thrown in alibaba/nacos.

Solutions

1. Correct the invalid value for contentDigest validation to match the expected format or allowed set, then retry.

When it happens

Trigger: Thrown at api/src/main/java/com/alibaba/nacos/api/ai/utils/AgentValidationUtils.java:200 when the library encounters an invalid state.

Common situations: Validating a storage descriptor with a malformed contentDigest.

AI-assisted analysis of alibaba/nacos@9b989acdf1 (2026-08-14). Data as JSON: /api/errors/3ef5d27100df220c. Report an issue: GitHub.

Appendix: source

Thrown at api/src/main/java/com/alibaba/nacos/api/ai/utils/AgentValidationUtils.java:200

     * @param transport transport token
     * @throws IllegalArgumentException when invalid
     */
    public static void validateTransport(String transport) {
        if (transport == null || transport.length() > MAX_TRANSPORT_LENGTH
            || !TRANSPORT_PATTERN.matcher(transport).matches()) {
            throw new IllegalArgumentException("Invalid transport: " + transport);
        }
    }
    
    /**
     * Validate a Version content digest.
     *
     * @param contentDigest content digest
     * @throws IllegalArgumentException when invalid
     */
    public static void validateContentDigest(String contentDigest) {
        if (contentDigest == null || !CONTENT_DIGEST_PATTERN.matcher(contentDigest).matches()) {
            throw new IllegalArgumentException("Invalid contentDigest: " + contentDigest);
        }
    }
    
    /**
     * Validate a descriptor media type.
     *
     * @param mediaType media type
     * @throws IllegalArgumentException when invalid
     */
    public static void validateMediaType(String mediaType) {
        if (mediaType == null || mediaType.length() > MAX_MEDIA_TYPE_LENGTH
            || !MEDIA_TYPE_PATTERN.matcher(mediaType).matches()) {
            throw new IllegalArgumentException("Invalid descriptorMediaType: " + mediaType);
        }
    }
    
    /**
     * Validate a required JSON-compatible value after request binding.

View on GitHub (pinned to 9b989acdf1)