Goa v3.27.0：Bearer Token 终于有了正经的身份认证 DSL

// 旧写法——语义上暗示了 JWT，但实际只做 token 提取
Security(JWTSecurity("token", func() {
    Header("Authorization:Bearer")
}))

package design

import (
    . "goa.design/goa/v3/dsl"
)

var _ = API("myapp", func() {
    Title("My Application")
    Version("1.0")
})

// 声明 Bearer 安全方案——不再伪装成 JWT
var BearerAuth = BearerSecurity("bearer")

var _ = Service("orders", func() {
    Description("订单管理服务")

    // 在整个服务上应用 Bearer 认证
    Security(BearerAuth)

    Method("list", func() {
        Description("列出当前用户的订单")
        Result(ArrayOf(Order))

        // 也可以在单个方法上单独声明
        // Security(BearerAuth)
    })

    Method("create", func() {
        Description("创建新订单")
        Payload(CreateOrderPayload)
        Result(Order)
        Security(BearerAuth)
    })
})

var Order = ResultType("application/vnd.myapp.order", func() {
    Attribute("id", String, "订单 ID")
    Attribute("total", Float64, "订单金额")
    Required("id", "total")
})

var CreateOrderPayload = Type("CreateOrderPayload", func() {
    Attribute("item", String, "商品名称")
    Attribute("quantity", Int, "数量")
    Required("item", "quantity")
})

package orders

import (
    "context"
    "errors"
    "strings"

    "myapp"
)

// orders_service.go —— Goa 生成的接口会要求你实现这个函数
func BearerAuth(ctx context.Context, token string) (context.Context, error) {
    // token 就是从 Authorization: Bearer <token> 提取出来的原始字符串
    // 这里做你自己的校验：查数据库、调外部验证服务、或简单判断非空

    if strings.TrimSpace(token) == "" {
        return ctx, errors.New("empty bearer token")
    }

    // 示例：把 token 解析后的用户 ID 放进 context
    userID, err := validateToken(token)
    if err != nil {
        return ctx, err
    }
    ctx = context.WithValue(ctx, myapp.UserIDKey, userID)
    return ctx, nil
}

func validateToken(token string) (string, error) {
    // 实际项目中替换为你的验证逻辑
    // 比如：调用 Auth 服务、查 Redis 缓存、或用本地公钥验签
    if token == "valid-test-token" {
        return "user-42", nil
    }
    return "", errors.New("invalid token")
}

# 1. 更新 Goa 依赖
go get goa.design/goa/v3@v3.27.0
go mod tidy

# 2. 重新生成代码
goa gen yourpkg/design

# 3. 如果之前用了 JWTSecurity 但实际只做 Bearer 提取，替换 DSL
#    把设计中的 JWTSecurity("token", ...) 改为 BearerSecurity("bearer")
#    把 Security(JWT) 改为 Security(BearerAuth)

# 4. 更新实现层的认证函数签名
#    旧: func JWTAuth(ctx, token string) (context.Context, error)
#    新: func BearerAuth(ctx, token string) (context.Context, error)
#    函数体逻辑通常不变，只需改名

# 5. 运行 lint 检查，确认生成代码不再触发警告
golangci-lint run ./...