alibaba/nacos · error · IllegalArgumentException

Invalid contentDigest: {contentDigest}

Error message

Invalid contentDigest: {contentDigest}

What it means

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

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)

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.