{"record":{"id":"8be920d803a4a229","repo":"caddyserver/caddy","slug":"error-decoding-ech-metadata-v-and-cleaning-up-p","errorCode":null,"errorMessage":"error decoding ECH metadata (%v) and cleaning up parent storage key %s: %v","messagePattern":"error decoding ECH metadata \\((.+?)\\) and cleaning up parent storage key (.+?): (.+?)","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"modules/caddytls/ech.go","lineNumber":596,"sourceCode":"\t\t\tzap.String(\"config_id\", configID),\n\t\t\tzap.Error(err))\n\t} else if err != nil {\n\t\tdelErr := storage.Delete(ctx, cfgIDKey)\n\t\tif delErr != nil {\n\t\t\treturn echConfig{}, fmt.Errorf(\"error loading ECH config metadata (%v) and cleaning up parent storage key %s: %v\", err, cfgIDKey, delErr)\n\t\t}\n\t\tlogger.Warn(\"could not load ECH config metadata; deleted its folder\",\n\t\t\tzap.String(\"config_id\", configID),\n\t\t\tzap.Error(err))\n\t\treturn echConfig{}, nil\n\t}\n\tvar meta echConfigMeta\n\tif len(metaBytes) > 0 {\n\t\tif err := json.Unmarshal(metaBytes, &meta); err != nil {\n\t\t\t// even though it's just metadata, reset the whole config since we can't reliably maintain it\n\t\t\tdelErr := storage.Delete(ctx, cfgIDKey)\n\t\t\tif delErr != nil {\n\t\t\t\treturn echConfig{}, fmt.Errorf(\"error decoding ECH metadata (%v) and cleaning up parent storage key %s: %v\", err, cfgIDKey, delErr)\n\t\t\t}\n\t\t\tlogger.Warn(\"could not JSON-decode ECH metadata; deleted its config folder\",\n\t\t\t\tzap.String(\"config_id\", configID),\n\t\t\t\tzap.Error(err))\n\t\t\treturn echConfig{}, nil\n\t\t}\n\t}\n\n\tcfg.privKeyBin = privKeyBytes\n\tcfg.configBin = echConfigBytes\n\tcfg.meta = meta\n\n\treturn cfg, nil\n}\n\nfunc generateAndStoreECHConfig(ctx caddy.Context, publicName string) (echConfig, error) {\n\t// Go currently has very strict requirements for server-side ECH configs,\n\t// to quote the Go 1.24 godoc (with typos of AEAD IDs corrected):","sourceCodeStart":578,"sourceCodeEnd":614,"githubUrl":"https://github.com/caddyserver/caddy/blob/50e54ee279aa1e504fe218ca49ab6ae16c100410/modules/caddytls/ech.go#L578-L614","documentation":"Error \"error decoding ECH metadata (%v) and cleaning up parent storage key %s: %v\" thrown in caddyserver/caddy.","triggerScenarios":"Thrown at modules/caddytls/ech.go:596 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Inspect both wrapped errors: the ECH metadata failed to decode, and cleanup of its storage key also failed. Check storage health and data integrity."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"50e54ee279aa1e504fe218ca49ab6ae16c100410","analyzedAt":"2026-08-15T09:20:21.641Z","schemaVersion":2},"datasetVersion":"2026-08-15T22:17:37.221Z"}