Ошибка "X does not implement Y (method has a pointer receiver)" в Go

Понимание проблемы: интерфейсы и набор методов

Ошибка, с которой вы столкнулись, — одна из самых частых у новичков в Go. Она связана с тем, как Go определяет набор методов для типов и как интерфейсы проверяют соответствие.

В Go каждый тип имеет свой набор методов. Для типа Dog (значение) и для типа *Dog (указатель на Dog) наборы методов различаются:

• Тип Dog (значение) имеет только методы, определённые на Dog (с receiver-значением).
• Тип *Dog (указатель) имеет все методы, определённые как на Dog, так и на *Dog.

В вашем примере метод Speak() определён на *Dog (pointer receiver). Это означает, что только *Dog имеет этот метод. Тип Dog (значение) его не имеет, поэтому Dog не реализует интерфейс Speaker.

Почему dog.Speak() работает напрямую?

Go автоматически разыменовывает указатели для удобства. Когда вы пишете dog.Speak(), где dog — это значение Dog, компилятор видит, что метод определён на *Dog, и автоматически берёт адрес: (&dog).Speak(). Это работает только для адресуемых значений (например, переменных, полей структур). Но при передаче в интерфейс такой автоматической трансформации не происходит — интерфейс требует точного соответствия.

Как исправить? Три способа

Способ 1: Передавать указатель в функцию

Самый простой способ — передавать не значение, а указатель на структуру:

func main() {
    dog := Dog{Name: "Бобик"}
    makeSpeak(&dog) // Передаём указатель — работает!
}

Способ 2: Изменить receiver на значение

Если метод не изменяет структуру, можно определить его на значении:

func (d Dog) Speak() string {
    return "Гав! Я " + d.Name
}

Теперь и Dog, и *Dog реализуют интерфейс.

Способ 3: Использовать указатель при создании переменной

func main() {
    dog := &Dog{Name: "Бобик"} // Сразу указатель
    makeSpeak(dog) // Работает
}

Правило выбора: pointer receiver vs value receiver

• Pointer receiver используйте, если метод:
  • Изменяет состояние структуры
  • Работает с большими структурами (избегает копирования)
• Value receiver используйте, если метод:
  • Не изменяет структуру (геттеры, методы чтения)
  • Структура маленькая и её копирование не критично

Если вы используете pointer receiver, будьте готовы, что интерфейс будут реализовывать только указатели. Документируйте это или используйте value receiver, когда это возможно.

// Dog реализует Speaker только через *Dog
type Dog struct {
    Name string
}

func NewDog(name string) *Dog {
    return &Dog{Name: name}
}