Go如何强制接口仅被带指针接收器的类型实现？

Go的类型系统中，指针类型会自动继承值类型的方法，因此无法直接通过接口约束强制SetParams必须使用指针接收器实现。不过可以通过以下几种方式解决你的问题：

1. 修改设计，避免依赖结构体字段存储参数 #

将Run方法改为直接接收请求参数，无需通过SetParams修改结构体状态，从根源上消除接收器问题：

package main

import (
    "encoding/json"
    "fmt"
    "log"
)

type PingParams struct {
    Name string
}

type PingResponse struct {
    Message string
}

func (p PingParams) Greeting() string {
    if p.Name != "" {
        return fmt.Sprintf("Hello, %s", p.Name)
    }
    return "Hello, nobody!"
}

type PingMethod struct{}

func (m PingMethod) Run(p PingParams) (*PingResponse, error) {
    return &PingResponse{Message: fmt.Sprintf("%T %s", m, p.Greeting())}, nil
}

type Method[RQ, RS any] interface {
    Run(p RQ) (*RS, error)
}

func HandlerMethod[M Method[RQ, RS], RQ, RS any](in json.RawMessage) (*RS, error) {
    var req RQ
    err := json.Unmarshal(in, &req)
    if err != nil {
        return nil, err
    }
    var m M
    return m.Run(req)
}

func main() {
    payload := []byte(`{"Name": "Mark"}`)

    res, err := HandlerMethod[PingMethod, PingParams, PingResponse](payload)
    if err != nil {
        log.Fatal(err)
    }
    fmt.Println(res.Message)
}

2. 运行时检查参数是否被正确设置 #

通过反射在HandlerMethod中检查调用SetParams后结构体的参数是否被更新，若未更新则返回错误，及时发现值接收器的问题：

package main

import (
    "encoding/json"
    "fmt"
    "log"
    "reflect"
)

type PingParams struct {
    Name string
}

type PingResponse struct {
    Message string
}

func (p PingParams) Greeting() string {
    if p.Name != "" {
        return fmt.Sprintf("Hello, %s", p.Name)
    }
    return "Hello, nobody!"
}

type GoodPing struct {
    Params PingParams
}

func (m *GoodPing) SetParams(p PingParams) {
    m.Params = p
}
func (m GoodPing) Run() (*PingResponse, error) {
    return &PingResponse{Message: fmt.Sprintf("%T %s", m, m.Params.Greeting())}, nil
}

type BadPing struct {
    Params PingParams
}

func (m BadPing) SetParams(p PingParams) {
    m.Params = p
}
func (m BadPing) Run() (*PingResponse, error) {
    return &PingResponse{Message: fmt.Sprintf("%T %s", m, m.Params.Greeting())}, nil
}

type Method[M, RQ, RS any] interface {
    *M
    Run() (*RS, error)
    SetParams(p RQ)
}

func HandlerMethod[M, RQ, RS any, T Method[M, RQ, RS]](in json.RawMessage) (*RS, error) {
    var req RQ
    err := json.Unmarshal(in, &req)
    if err != nil {
        return nil, err
    }

    var m T = new(M)
    m.SetParams(req)

    // 运行时检查Params字段是否被正确设置
    elem := reflect.ValueOf(m).Elem()
    paramsField := elem.FieldByName("Params")
    if !paramsField.IsValid() {
        return nil, fmt.Errorf("type %T missing Params field", m)
    }
    if !reflect.DeepEqual(paramsField.Interface(), req) {
        return nil, fmt.Errorf("SetParams for type %T must use pointer receiver", m)
    }

    return m.Run()
}

func main() {
    payload := []byte(`{"Name": "Mark"}`)

    // 调用BadPing会触发运行时错误
    _, err := HandlerMethod[BadPing, PingParams, PingResponse](payload)
    if err != nil {
        log.Println(err) // 输出：SetParams for type *main.BadPing must use pointer receiver
    }

    good, err := HandlerMethod[GoodPing, PingParams, PingResponse](payload)
    if err != nil {
        log.Fatal(err)
    }
    fmt.Println(good.Message)
}

3. 自定义go vet规则 #

编写自定义的go vet检查规则，扫描代码中所有实现SetParams方法的类型，若使用值接收器则抛出警告。将vet检查集成到编译流程中，可近似实现编译时错误的效果。

内容的提问来源于stack exchange，提问作者Mark Chambers