{"record":{"id":"94c44835d3f0945d","repo":"alibaba/nacos","slug":"invalid-protocol-protocol","errorCode":null,"errorMessage":"Invalid protocol: {protocol}","messagePattern":"Invalid protocol: (.+?)","errorType":"validation","errorClass":"IllegalArgumentException","httpStatus":null,"severity":"error","filePath":"api/src/main/java/com/alibaba/nacos/api/ai/utils/AgentValidationUtils.java","lineNumber":135,"sourceCode":"     * Validate an Agent version range.\n     *\n     * @param versionRange version range text\n     * @throws IllegalArgumentException when invalid\n     */\n    public static void validateVersionRange(String versionRange) {\n        AgentVersionRange.parse(versionRange);\n    }\n    \n    /**\n     * Validate a protocol token.\n     *\n     * @param protocol protocol token\n     * @throws IllegalArgumentException when invalid\n     */\n    public static void validateProtocol(String protocol) {\n        if (protocol == null || protocol.length() > MAX_PROTOCOL_LENGTH\n            || !PROTOCOL_PATTERN.matcher(protocol).matches()) {\n            throw new IllegalArgumentException(\"Invalid protocol: \" + protocol);\n        }\n    }\n    \n    /**\n     * Validate an optional protocol-version value when present.\n     *\n     * @param protocolVersion protocol-version value\n     * @throws IllegalArgumentException when invalid\n     */\n    public static void validateProtocolVersion(String protocolVersion) {\n        if (protocolVersion == null || protocolVersion.isEmpty()\n            || protocolVersion.length() > MAX_PROTOCOL_VERSION_LENGTH) {\n            throw new IllegalArgumentException(\"Invalid protocolVersion: \" + protocolVersion);\n        }\n        validatePrintableAscii(protocolVersion, \"protocolVersion\");\n    }\n    \n    /**","sourceCodeStart":117,"sourceCodeEnd":153,"githubUrl":"https://github.com/alibaba/nacos/blob/9b989acdf181d00898f2e8839257bb2b2a3cefe3/api/src/main/java/com/alibaba/nacos/api/ai/utils/AgentValidationUtils.java#L117-L153","documentation":"Error \"Invalid protocol: {protocol}\" thrown in alibaba/nacos.","triggerScenarios":"Thrown at api/src/main/java/com/alibaba/nacos/api/ai/utils/AgentValidationUtils.java:135 when the library encounters an invalid state.","commonSituations":"Validating an endpoint or call interface with a protocol value that fails the allowed pattern.","solutions":["Correct the invalid value for protocol validation to match the expected format or allowed set, then retry."],"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"}