{"record":{"id":"85fbbf172d5c9428","repo":"GoogleContainerTools/jib","slug":"property-cannot-be-greater-than-validrange","errorCode":null,"errorMessage":"property + \" cannot be greater than \" + validRange.upperEndpoint() + \": \" + value","messagePattern":"property \\+ \" cannot be greater than \" \\+ validRange\\.upperEndpoint\\(\\) \\+ \": \" \\+ value","errorType":"validation","errorClass":"NumberFormatException","httpStatus":null,"severity":"error","filePath":"jib-core/src/main/java/com/google/cloud/tools/jib/global/JibSystemProperties.java","lineNumber":142,"sourceCode":"  }\n\n  private static void checkNumericSystemProperty(String property, Range<Integer> validRange) {\n    String value = System.getProperty(property);\n    if (value == null) {\n      return;\n    }\n\n    int parsed;\n    try {\n      parsed = Integer.parseInt(value);\n    } catch (NumberFormatException ex) {\n      throw new NumberFormatException(property + \" must be an integer: \" + value);\n    }\n    if (validRange.hasLowerBound() && validRange.lowerEndpoint() > parsed) {\n      throw new NumberFormatException(\n          property + \" cannot be less than \" + validRange.lowerEndpoint() + \": \" + value);\n    } else if (validRange.hasUpperBound() && validRange.upperEndpoint() < parsed) {\n      throw new NumberFormatException(\n          property + \" cannot be greater than \" + validRange.upperEndpoint() + \": \" + value);\n    }\n  }\n\n  private JibSystemProperties() {}\n}\n","sourceCodeStart":124,"sourceCodeEnd":149,"githubUrl":"https://github.com/GoogleContainerTools/jib/blob/fb949e2676afbbd7dd7a1ef61e20251931325654/jib-core/src/main/java/com/google/cloud/tools/jib/global/JibSystemProperties.java#L124-L149","documentation":"The mirror of the lower-bound check: thrown when a numeric Jib system property parses but exceeds the property's upper bound. The message includes the property name, the maximum allowed, and the offending value.","triggerScenarios":"Setting -Djib.httpTimeout above the maximum allowed milliseconds value, or -Djib.proxy.port greater than 65535.","commonSituations":"Setting a port like 80800 (typo, extra digit), huge timeout values meant as 'infinite', unexpanded template variables resolving to absurd numbers.","solutions":["Use a proxy port in 1-65535, e.g. -Djib.proxy.port=8080","Cap jib.httpTimeout at the documented maximum (Integer-range) milliseconds","Remove the property to use defaults","Fix typos/extra digits in the value"],"exampleFix":"// before\ngradle jib -Djib.proxy.port=80800\n// after\ngradle jib -Djib.proxy.port=8080","handlingStrategy":"validation","validationCode":"int port = Integer.parseInt(System.getProperty(\"jib.proxy.port\", \"0\"));\nif (port < 1 || port > 65535) throw new IllegalArgumentException(\"jib.proxy.port out of range: \" + port);","typeGuard":null,"tryCatchPattern":"try { jibStep(); } catch (NumberFormatException e) { if (e.getMessage().contains(\"cannot be greater than\")) { failBuild(\"Value too large: \" + e.getMessage()); } throw e; }","preventionTips":["Keep ports within 1-65535","Watch for typos with extra digits in port numbers","Cap timeouts at Integer.MAX_VALUE milliseconds"],"tags":["configuration","system-properties","validation","number-format"],"backgroundTag":"value-out-of-range","analyzedSha":"fb949e2676afbbd7dd7a1ef61e20251931325654","analyzedAt":"2026-09-06T14:04:09.491Z","contentChangedAt":"2026-09-06T14:04:09.491Z","schemaVersion":2},"datasetVersion":"2026-09-14T05:17:10.506Z"}