«X does not implement Y»: analizando el error con pointer receiver en Go

Introducción: el momento de la verdad para el desarrollador Go

Si alguna vez has programado en Go (Golang) y has usado interfaces, seguramente te has encontrado con este mensaje del compilador:

cannot use x (variable of type *MyStruct) as type MyInterface value in assignment:\n*MyStruct does not implement MyInterface (method GetName has a pointer receiver)

En Stack Overflow, esta pregunta acumula miles de visitas. Los principiantes se quedan perplejos, los experimentados se encogen de hombros. Pero en realidad, detrás de este error hay un concepto elegante e importante: la diferencia entre value receiver y pointer receiver en el lenguaje Go.

En este artículo, exploraremos «bajo el capó» del compilador Go, analizaremos ejemplos reales de código y entenderemos cómo evitar esta trampa. Aprenderás no solo por qué ocurre el error, sino también cómo se relaciona con el sistema de tipos e interfaces.

1. Interfaces en Go: breve introducción

Antes de sumergirnos en el error, recordemos cómo funcionan las interfaces de Go. A diferencia de Java o C++, en Go una interfaz es un conjunto de métodos. Si un tipo implementa todos los métodos de la interfaz, automáticamente satisface esa interfaz (tipado pato).

Ejemplo de una interfaz simple:

type Speaker interface {\n    Speak() string\n}

Ahora definamos una estructura y un método:

type Dog struct {\n    Name string\n}\n\n// Value receiver — el método trabaja con una copia de la estructura\nfunc (d Dog) Speak() string {\n    return "¡Guau! Soy " + d.Name\n}

Aquí, Dog implementa Speaker. Funciona tanto con Dog como con *Dog:

var s Speaker\ns = Dog{Name: "Bobby"}  // ✅ OK\ns = &Dog{Name: "Rex"}  // ✅ OK (Go desreferencia automáticamente)

Todo simple por ahora. Ahora cambiemos el método a pointer receiver:

func (d *Dog) Speak() string {\n    return "¡Guau! Soy " + d.Name\n}

Y aquí comienza la magia.

2. Pointer receiver vs Value receiver: ¿cuál es la diferencia?

En Go, los métodos pueden tener dos tipos de receptores (receivers):

\n
• Value receiver (t Type) — el método recibe una copia del valor.
\n
• Pointer receiver (t *Type) — el método recibe un puntero al valor original.
\n

¿Por qué es importante? Porque el conjunto de métodos de un tipo depende del receiver que se utilice.

Tabla de verdad:

\n
• El tipo T tiene todos los métodos con value receiver (para T).
\n
• El tipo *T tiene todos los métodos con value receiver + pointer receiver.
\n

En otras palabras: el puntero obtiene un «conjunto adicional» de métodos, mientras que el valor solo tiene aquellos declarados con value receiver.

Esto no es un error, sino una característica del diseño de Go. El compilador no puede tomar automáticamente la dirección de un valor si este no es direccionable (por ejemplo, el resultado de una función o un literal).

3. Análisis del error: «method has a pointer receiver»

Volvamos a nuestro ejemplo. Si Speak() está declarado con *Dog, entonces:

var s Speaker\ns = Dog{Name: "Bobby"}  // ❌ ERROR\n// cannot use Dog{...} as Speaker...\n// method has a pointer receiver

¿Por qué? Porque Dog (no puntero) no tiene el método Speak() en su conjunto. El método pertenece solo a *Dog.

Pero esto sí funciona:

s = &Dog{Name: "Bobby"}  // ✅ OK

Ahora analicemos un ejemplo más realista de código que a menudo se encuentra en Stack Overflow.

Ejemplo: interfaz y estructura con datos

package main\n\nimport "fmt"\n\ntype User interface {\n    GetID() int\n    SetName(name string)\n}\n\ntype Admin struct {\n    ID   int\