{"record":{"id":"a08b1a6879c73400","repo":"weaviate/weaviate","slug":"s-must-be-an-integer-between-1-and-d-got-v","errorCode":null,"errorMessage":"%s must be an integer between 1 and %d. Got: %v","messagePattern":"(.+?) must be an integer between 1 and (.+?)\\. Got: (.+?)","errorType":"validation","errorClass":null,"httpStatus":null,"severity":"error","filePath":"usecases/config/environment.go","lineNumber":2411,"sourceCode":"\n\t// parseIntVerify always writes the default back, so seed it from the config\n\t// file value to keep an unset variable from overwriting it.\n\tconnPool := DefaultBackupGCSGRPCConnPool\n\tif c.BackupGCS.GRPCConnPool != 0 {\n\t\tconnPool = c.BackupGCS.GRPCConnPool\n\t}\n\tif err := parseIntVerify(\"GCS_MODULE_GRPC_CONN_POOL\", connPool,\n\t\tfunc(val int) { c.BackupGCS.GRPCConnPool = val },\n\t\tvalidateBackupGCSConnPool); err != nil {\n\t\treturn err\n\t}\n\n\treturn nil\n}\n\nfunc validateBackupGCSConnPool(val int, setting string) error {\n\tif val < 1 || val > MaxBackupGCSGRPCConnPool {\n\t\treturn fmt.Errorf(\"%s must be an integer between 1 and %d. Got: %v\", setting, MaxBackupGCSGRPCConnPool, val)\n\t}\n\treturn nil\n}\n","sourceCodeStart":2393,"sourceCodeEnd":2415,"githubUrl":"https://github.com/weaviate/weaviate/blob/75aa4b6d11f8818305aafd4440b4e32794f7ca04/usecases/config/environment.go#L2393-L2415","documentation":"Configuration validation error for GCS_MODULE_GRPC_CONN_POOL: the value falls outside the allowed range [1, MaxBackupGCSGRPCConnPool]. A zero/negative or excessively large connection pool size for the GCS gRPC client is rejected.","triggerScenarios":"Setting the GCS gRPC connection pool env var to 0, a negative number, or a value above the documented maximum.","commonSituations":"Oversizing the pool 'for safety' after performance tuning; copy-pasting a different module's pool size; leaving 0 in a generated values file.","solutions":["Set the value to an integer between 1 and MaxBackupGCSGRPCConnPool (see message for the max)","Unset the variable to fall back to DefaultBackupGCSGRPCConnPool","If you need more concurrency, check the current max constant in usecases/config/environment.go and raise it deliberately"],"exampleFix":"# before\nBACKUP_GCS_CONN_POOL=0\n# after\nBACKUP_GCS_CONN_POOL=10","handlingStrategy":"validation","validationCode":"v := os.Getenv(\"BACKUP_GCS_CONN_POOL\")\nif v != \"\" {\n  n, err := strconv.Atoi(v)\n  if err != nil || n < 1 || n > 1000 { log.Fatalf(\"conn pool must be in [1, max]\") }\n}","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Start from the documented default and change only with measured need","Enforce bounds in config templates/CI","Avoid hand-editing generated values files"],"tags":["config","env-var","validation","backup","gcs"],"backgroundTag":"invalid-env-var-value","analyzedSha":"75aa4b6d11f8818305aafd4440b4e32794f7ca04","analyzedAt":"2026-09-04T14:58:20.392Z","contentChangedAt":"2026-09-04T14:58:20.392Z","schemaVersion":2},"datasetVersion":"2026-09-11T21:17:09.523Z"}