{"record":{"id":"d28cd668c9cd0dec","repo":"risingwavelabs/risingwave","slug":"schema-registry-client-error-0","errorCode":null,"errorMessage":"schema registry client error: {0}","messagePattern":"schema registry client error: (.+?)","errorType":"exception","errorClass":"SchemaFetchError::Client","httpStatus":null,"severity":"error","filePath":"src/connector/src/schema/mod.rs","lineNumber":71,"sourceCode":"    #[error(transparent)]\n    AwsGlue(#[from] Box<aws_sdk_glue::operation::get_schema_version::GetSchemaVersionError>),\n    #[error(transparent)]\n    MalformedResponse(#[from] MalformedResponseError),\n    #[error(\"schema version id invalid: {0}\")]\n    InvalidUuid(#[from] uuid::Error),\n    #[error(\"schema compilation error: {0}\")]\n    SchemaCompile(\n        #[source]\n        #[backtrace]\n        risingwave_common::error::BoxedError,\n    ),\n    #[error(\"{0}\")] // source+{0} is effectively transparent but allows backtrace\n    YetToMigrate(\n        #[source]\n        #[backtrace]\n        ConnectorError,\n    ),\n    #[error(\"schema registry client error: {0}\")]\n    Client(#[from] schema_registry::SchemaRegistryClientError),\n}\n","sourceCodeStart":53,"sourceCodeEnd":74,"githubUrl":"https://github.com/risingwavelabs/risingwave/blob/6469eb736d691e8e9b8a419a57edd6429ca77417/src/connector/src/schema/mod.rs#L53-L74","documentation":"SchemaFetchError::Client wraps schema_registry::SchemaRegistryClientError: the schema registry client itself failed — request construction, HTTP transport errors, or non-success registry responses handled at client level.","triggerScenarios":"Any schema registry client call (fetch schema by id/subject/version, Confluent requests) failing due to network issues, DNS failure, TLS errors, or registry-side errors before response parsing.","commonSituations":"Registry unreachable (wrong host/port, firewall), registry returning 4xx/5xx (auth required, subject not found), TLS certificate issues in on-prem deployments.","solutions":["Verify the registry URL is reachable from the RisingWave node: curl http://<registry>/subjects.","Check network/TLS: firewall rules, DNS, proxy and CA certificates.","Check registry auth requirements and registry logs for 4xx/5xx causes."],"exampleFix":"// before\nWITH (schema.registry = 'http://registry-internal:8081') // unreachable from RW node\n// after\nWITH (schema.registry = 'http://localhost:8081') // or fix network/DNS","handlingStrategy":"retry","validationCode":"// preflight connectivity check\n// curl -fsS http://registry:8081/subjects >/dev/null || echo 'registry unreachable'","typeGuard":null,"tryCatchPattern":"match fetch_schema() {\n    Err(e) if e.to_string().starts_with(\"schema registry client error\") => {\n        // check network/auth, retry with backoff for transient 5xx\n    }\n    Err(e) => return Err(e.into()),\n    Ok(s) => s,\n}","preventionTips":["Monitor registry availability and set up retries with backoff.","Pre-provision network paths (DNS, firewall, TLS) from RW nodes to the registry.","Configure registry auth credentials before deploying sources."],"tags":["schema-registry","network","http","client"],"backgroundTag":"http-request-failed","analyzedSha":"6469eb736d691e8e9b8a419a57edd6429ca77417","analyzedAt":"2026-09-11T21:06:21.487Z","contentChangedAt":"2026-09-11T21:06:21.487Z","schemaVersion":2},"datasetVersion":"2026-09-14T16:17:12.679Z"}