{"record":{"id":"bef3f158ce1f173b","repo":"alibaba/nacos","slug":"endpoint-metadata-exceeds-max-metadata-size-entr","errorCode":null,"errorMessage":"Endpoint metadata exceeds {MAX_METADATA_SIZE} entries","messagePattern":"Endpoint metadata exceeds (.+?) entries","errorType":"validation","errorClass":"IllegalArgumentException","httpStatus":null,"severity":"error","filePath":"api/src/main/java/com/alibaba/nacos/api/ai/utils/AgentValidationUtils.java","lineNumber":241,"sourceCode":"     */\n    public static void validateNonNullJsonValue(Object value, String fieldName) {\n        if (value == null) {\n            throw new IllegalArgumentException(fieldName + \" must not be JSON null\");\n        }\n    }\n    \n    /**\n     * Validate optional public Endpoint metadata.\n     *\n     * @param metadata Endpoint metadata, or {@code null}\n     * @throws IllegalArgumentException when invalid or using a reserved key\n     */\n    public static void validateEndpointMetadata(Map<String, String> metadata) {\n        if (metadata == null) {\n            return;\n        }\n        if (metadata.size() > MAX_METADATA_SIZE) {\n            throw new IllegalArgumentException(\n                \"Endpoint metadata exceeds \" + MAX_METADATA_SIZE + \" entries\");\n        }\n        for (Map.Entry<String, String> entry : metadata.entrySet()) {\n            String key = entry.getKey();\n            String value = entry.getValue();\n            if (key == null || key.isEmpty() || codePointLength(key) > MAX_METADATA_KEY_LENGTH\n                || isReservedMetadataKey(key)) {\n                throw new IllegalArgumentException(\"Invalid Endpoint metadata key: \" + key);\n            }\n            if (value == null || codePointLength(value) > MAX_METADATA_VALUE_LENGTH) {\n                throw new IllegalArgumentException(\n                    \"Invalid Endpoint metadata value for key: \" + key);\n            }\n        }\n    }\n    \n    private static boolean isReservedMetadataKey(String key) {\n        return \"preserved.heart.beat.interval\".equals(key)","sourceCodeStart":223,"sourceCodeEnd":259,"githubUrl":"https://github.com/alibaba/nacos/blob/9b989acdf181d00898f2e8839257bb2b2a3cefe3/api/src/main/java/com/alibaba/nacos/api/ai/utils/AgentValidationUtils.java#L223-L259","documentation":"Error \"Endpoint metadata exceeds {MAX_METADATA_SIZE} entries\" thrown in alibaba/nacos.","triggerScenarios":"Thrown at api/src/main/java/com/alibaba/nacos/api/ai/utils/AgentValidationUtils.java:241 when the library encounters an invalid state.","commonSituations":"Endpoint metadata contains more entries than the configured maximum.","solutions":["Reduce the size or count of the input so it stays within the configured limit."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"9b989acdf181d00898f2e8839257bb2b2a3cefe3","analyzedAt":"2026-08-14T07:17:31.569Z","schemaVersion":2},"datasetVersion":"2026-08-14T10:17:34.591Z"}