Respuesta.

Historia de la pregunta:

En Go no hay contenedores universales del tipo mapa genérico por defecto: solo a partir de Go 1.18 aparecieron las generics, pero para estructuras dinámicas, antes y ahora, se usa frecuentemente map[string]interface{}, lo que permite almacenar valores de cualquier tipo con una clave de cadena.

Problema:

Este patrón es análogo a un diccionario/objeto JSON, se encuentra en todas partes para la serialización, trabajo con middleware, y datos sin una estructura definida (por ejemplo, un analizador JSON a través de encoding/json). Sin embargo, acceder a los valores requiere conversión manual de tipos y precaución con valores nulos y la ausencia de claves.

Solución:

Usar map[string]interface{} donde no se conoce la estructura de los datos de entrada. Comprobar cuidadosamente la existencia de la clave, convertir el tipo (type assertion) solo después de el exists-idiom. Es mejor no mantener tales mapas "profundamente" en la lógica de negocio, sino como adaptadores en los bordes del sistema.

Ejemplo de código:

obj := map[string]interface{}{
    "int": 42,
    "str": "hola",
    "flag": true,
}

if v, ok := obj["int"]; ok {
    n, success := v.(int)
    if success {
        fmt.Println(n)
    }
}

Características clave:

Permite almacenar valores de cualquier tipo en un solo mapa.
Requiere un control estricto al convertir tipos y leer valores.
Se usa con frecuencia para API de JSON/HTTP, pero no se recomienda para la lógica principal de negocio.

Preguntas con trampa.

¿Se puede acceder sin errores al valor por clave en map[string]interface{} si la clave no existe?

No, esto dará el "cero value" (nil) para interface{}, la conversión de tipo a un tipo específico generará pánico.

¿Qué ocurre al serializar map[string]interface{} con slices anidados u otros mapas?

La serialización JSON procesará correctamente la estructura, pero si hay tipos que no son soportados por defecto (canales, funciones) habrá un error de marshaling.

¿Se pueden comparar dos valores en map[string]interface{} con ==?

No, interface{} solo se puede comparar si el valor subyacente es comparable. Si se incluye un mapa o un slice, habrá pánico al comparar.

Errores comunes y anti-patrones

No hacer type assertion, asumiendo que siempre es del tipo correcto.
Mantener mapas "crudos" en la lógica de la aplicación, en lugar de en los bordes/al parsear.
No comprobar la existencia de una clave antes de leer.

Ejemplo de la vida real

Caso negativo

En la aplicación toda la lógica se basa en objetos map[string]interface{}, cada controlador/servicio los pasa profundamente a través de las llamadas.

Ventajas:

Flexible, permite iniciar rápidamente un prototipo.

Desventajas:

No hay verificación de tipos: los errores se manifiestan en tiempo de ejecución.
Difícil de leer y mantener el código.

Caso positivo

Se utilizan map[string]interface{} solo para trabajar con interfaces externas, datos de entrada/salida, y luego se traducen a estructuras normales.