{"record":{"id":"bc7faad961b062b6","repo":"juicedata/juicefs","slug":"get-start-v-s-bc7faa","errorCode":null,"errorMessage":"get start %v: %s","messagePattern":"get start (.+?): (.+?)","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"pkg/object/etcd.go","lineNumber":130,"sourceCode":"\treturn string(next)\n}\n\nfunc (c *etcdClient) List(ctx context.Context, prefix, start, token, delimiter string, limit int64, followLink bool) ([]Object, bool, string, error) {\n\tif delimiter != \"\" {\n\t\treturn nil, false, \"\", notSupported\n\t}\n\tif start == \"\" {\n\t\tstart = prefix\n\t}\n\tvar opts = []etcd.OpOption{etcd.WithLimit(limit), etcd.WithSort(etcd.SortByKey, etcd.SortAscend)}\n\tif len(prefix) > 0 && prefix[0] != 0xFF {\n\t\topts = append(opts, etcd.WithRange(genNextKey(prefix)))\n\t} else {\n\t\topts = append(opts, etcd.WithFromKey())\n\t}\n\tresp, err := c.client.Get(ctx, start, opts...)\n\tif err != nil {\n\t\treturn nil, false, \"\", fmt.Errorf(\"get start %v: %s\", start, err)\n\t}\n\tvar objs []Object\n\tfor _, kv := range resp.Kvs {\n\t\tk := string(kv.Key)\n\t\tif !strings.HasPrefix(k, prefix) {\n\t\t\tbreak\n\t\t}\n\t\tobjs = append(objs, &obj{\n\t\t\tk,\n\t\t\tint64(len(kv.Value)),\n\t\t\ttime.Now(),\n\t\t\tstrings.HasSuffix(k, \"/\"),\n\t\t\t\"\",\n\t\t\t\"\",\n\t\t})\n\t}\n\tvar nextMarker string\n\tif resp.More && len(objs) > 0 {","sourceCodeStart":112,"sourceCodeEnd":148,"githubUrl":"https://github.com/juicedata/juicefs/blob/c9a67b23e8e08ec23ec331aa6f1675e2319e921c/pkg/object/etcd.go#L112-L148","documentation":"Returned by etcdClient.List when the etcd Get call for the range starting at the computed start key fails. It wraps the etcd client error (unreachable endpoint, timeout, auth) so listing cannot produce keys.","triggerScenarios":"Thrown at pkg/object/etcd.go:130 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Check etcd endpoint health and network connectivity","Verify etcd credentials if authentication is enabled"],"exampleFix":null,"handlingStrategy":"retry","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"c9a67b23e8e08ec23ec331aa6f1675e2319e921c","analyzedAt":"2026-09-06T17:55:48.476Z","contentChangedAt":"2026-09-06T17:55:48.476Z","schemaVersion":2},"datasetVersion":"2026-09-14T05:17:10.506Z"}