temporalio/temporal · error

failed to load search attributes for fallback index %q: %w

Error message

failed to load search attributes for fallback index %q: %w

What it means

Error "failed to load search attributes for fallback index %q: %w" thrown in temporalio/temporal.

Source

Thrown at common/searchattribute/mapper.go:116

		namespaceRegistry:        namespaceRegistry,
		searchAttributesProvider: searchAttributesProvider,
		fallbackIndexName:        fallbackIndexName,
	}
}

func (m *mapperProviderImpl) GetMapper(nsName namespace.Name) (Mapper, error) {
	if m.customMapper != nil {
		return m.customMapper, nil
	}
	saMapper, err := m.namespaceRegistry.GetCustomSearchAttributesMapper(nsName)
	if err != nil {
		return nil, err
	}
	fallbackNameTypeMap := NameTypeMap{}
	if m.fallbackIndexName != "" {
		nameTypeMap, err := m.searchAttributesProvider.GetSearchAttributes(m.fallbackIndexName, false)
		if err != nil {
			return nil, fmt.Errorf("failed to load search attributes for fallback index %q: %w", m.fallbackIndexName, err)
		}
		fallbackNameTypeMap = legacyCustomSearchAttributes(nameTypeMap)
	}
	return &backCompMapper{
		mapper:              &saMapper,
		fallbackNameTypeMap: fallbackNameTypeMap,
	}, nil
}

func legacyCustomSearchAttributes(nameTypeMap NameTypeMap) NameTypeMap {
	legacyCustomSearchAttributes := make(map[string]enumspb.IndexedValueType)
	for name, valueType := range nameTypeMap.Custom() {
		if sadefs.IsPreallocatedCSAFieldName(name, valueType) {
			continue
		}
		legacyCustomSearchAttributes[name] = valueType
	}
	return NewNameTypeMap(legacyCustomSearchAttributes)

View on GitHub (pinned to bde624efd1)

When it happens

Trigger: Thrown at common/searchattribute/mapper.go:116 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of temporalio/temporal@bde624efd1 (2026-09-01). Data as JSON: /api/errors/5f8721a9eb09f95d. Report an issue: GitHub.