go - 急忙:没有规范可解码

Question

我正在尝试为用Golang编写的REST端点定义一个 Swagger 操作。我需要指定POST请求正文和响应。

// swagger:operation POST /user user createUser
//
// Creates user
//
// produces:
// - application/json
// parameters:
// - name: requestBody
//   in: body
//   description: user details
//   required: true
//   schema:
//     "$ref": "#/definitions/User"
// responses:
//  200: CommonResponse
//  400: CommonResponse
//  500: CommonResponse

// CreateUser will create user
func (h *UserHandler) CreateUser(c *gin.Context) {

但是尝试生成相同的规范时出现错误错误

cd cmd/server && GO111MODULE=on swagger generate spec -o ../../api/swagger.json -m
operation (createUser): no spec available to unmarshal
Makefile:5: recipe for target 'generate-swagger' failed
make: *** [generate-swagger] Error 1

请帮我这些。此处指定的规范是什么。
预先感谢

Answer 1

我认为您缺少在yaml部分之前必须出现的一组破折号---。

(请参见本页上示例上方的行:https://goswagger.io/use/spec/operation.html)

此更新的注释应为您工作:

// swagger:operation POST /user user createUser
//
// Creates user
//
// ---
// produces:
// - application/json
// parameters:
// - name: requestBody
//   in: body
//   description: user details
//   required: true
//   schema:
//     "$ref": "#/definitions/User"
// responses:
//  200: CommonResponse
//  400: CommonResponse
//  500: CommonResponse