{"record":{"id":"464757ed2f589cdd","repo":"googleapis/mcp-toolbox","slug":"failed-to-reach-graph-q-w","errorCode":null,"errorMessage":"failed to reach graph %q: %w","messagePattern":"failed to reach graph %q: %w","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"internal/tools/falkordb/falkordbschema/falkordbschema.go","lineNumber":166,"sourceCode":"\n// extractSchema orchestrates the concurrent extraction of the graph schema.\nfunc (t Tool) extractSchema(ctx context.Context, source compatibleSource) (*types.SchemaInfo, error) {\n\tschema := &types.SchemaInfo{\n\t\tGraphInfo: types.GraphInfo{Name: source.DefaultGraph()},\n\t\tStatistics: types.Statistics{\n\t\t\tNodesByLabel:        make(map[string]int64),\n\t\t\tRelationshipsByType: make(map[string]int64),\n\t\t},\n\t}\n\n\t// FalkorDB creates graph keys lazily, so a graph nothing has written to\n\t// yet does not exist and every query on it fails. Report it as an empty\n\t// schema instead.\n\tif _, err := runReadQuery(ctx, source, \"RETURN 1\"); err != nil {\n\t\tif strings.Contains(err.Error(), \"empty key\") {\n\t\t\treturn schema, nil\n\t\t}\n\t\treturn nil, fmt.Errorf(\"failed to reach graph %q: %w\", source.DefaultGraph(), err)\n\t}\n\n\tvar mu sync.Mutex\n\n\ttasks := []struct {\n\t\tname string\n\t\tfn   func() error\n\t}{\n\t\t{\n\t\t\tname: \"node-schema\",\n\t\t\tfn: func() error {\n\t\t\t\tnodeLabels, err := t.extractNodeLabels(ctx, source)\n\t\t\t\tif err != nil {\n\t\t\t\t\treturn fmt.Errorf(\"failed to extract node schema: %w\", err)\n\t\t\t\t}\n\t\t\t\tmu.Lock()\n\t\t\t\tdefer mu.Unlock()\n\t\t\t\tschema.NodeLabels = nodeLabels","sourceCodeStart":148,"sourceCodeEnd":184,"githubUrl":"https://github.com/googleapis/mcp-toolbox/blob/8cc6e09de2ad7b8bffc77751799585a1401a48eb/internal/tools/falkordb/falkordbschema/falkordbschema.go#L148-L184","documentation":"Connectivity probe failure in extractSchema: the warm-up query 'RETURN 1' against the default graph failed with an error other than 'empty key', meaning the FalkorDB instance is unreachable, misconfigured, or the graph key is in a bad state.","triggerScenarios":"Thrown at internal/tools/falkordb/falkordbschema/falkordbschema.go:166 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Verify the FalkorDB host, port and credentials in the source configuration","Confirm the graph key exists and is not corrupted","Check network connectivity and that the FalkorDB server is running"],"exampleFix":null,"handlingStrategy":"try-catch","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"8cc6e09de2ad7b8bffc77751799585a1401a48eb","analyzedAt":"2026-09-05T01:10:36.887Z","contentChangedAt":"2026-09-05T01:10:36.887Z","schemaVersion":2},"datasetVersion":"2026-09-08T10:18:20.063Z"}