go-redis/redis · error

invalid synonym format

Error message

invalid synonym format

What it means

Error "invalid synonym format" thrown in go-redis/redis.

Source

Thrown at search_commands.go:3618

	}

	var results []FTSynDumpResult
	for i := 0; i < len(termSynonymPairs); i += 2 {
		term, ok := termSynonymPairs[i].(string)
		if !ok {
			return fmt.Errorf("invalid term format")
		}

		synonyms, ok := termSynonymPairs[i+1].([]interface{})
		if !ok {
			return fmt.Errorf("invalid synonyms format")
		}

		synonymList := make([]string, len(synonyms))
		for j, syn := range synonyms {
			synonym, ok := syn.(string)
			if !ok {
				return fmt.Errorf("invalid synonym format")
			}
			synonymList[j] = synonym
		}

		results = append(results, FTSynDumpResult{
			Term:     term,
			Synonyms: synonymList,
		})
	}

	cmd.val = results
	return nil
}

// parseFTSynDumpRESP3 parses the RESP3 format response from FT.SYNDUMP.
// RESP3 format:
//
//	map{

View on GitHub (pinned to 36d97525cd)

Solutions

1. Check the synonym entry format returned by the server; parse entries generically if the schema varies
2. Verify RediSearch version compatibility

When it happens

Trigger: Thrown at search_commands.go:3618 when the library encounters an invalid state.

Common situations: Pin and test against the RediSearch module version in use.

AI-assisted analysis of go-redis/redis@36d97525cd (2026-08-06). Data as JSON: /data/errors/4d351f8b5e81b16a.json. Report an issue: GitHub.