如何让Plumber的PUT端点同时兼容Swagger示例与真实请求？

你遇到的问题是Plumber的PUT端点在Swagger测试和外部请求中，请求体的解析路径不一致：Swagger中请求体被嵌套在req$body$body，而外部请求直接在req$body，单个端点加判断的方案在多端点场景下效率极低。以下是几种通用解决方案：

方案1：全局过滤器统一处理请求体 #

通过Plumber的全局过滤器，在所有端点执行前统一调整请求体结构，无需逐个修改端点代码：

#* 全局修正Swagger请求体嵌套问题
#* @filter swagger_body_normalize
function(req) {
  # 判断请求是否来自Swagger相关页面
  if (!is.null(req$HTTP_REFERER) && grepl("/__docs__/|/__swagger__/|/openapi.json", req$HTTP_REFERER)) {
    # 若存在嵌套的body结构，替换为内层内容
    if (!is.null(req$body$body)) {
      req$body <- req$body$body
    }
  }
  forward() # 继续处理后续请求
}

将这段过滤器代码放在所有端点定义之前，所有接口都会自动适配Swagger和外部请求的请求体格式，无需额外修改端点逻辑。

方案2：统一从req$body获取请求体（放弃自动注入） #

修改端点函数，不再依赖Plumber自动注入的body参数，而是直接从req对象中兼容两种场景的请求体：

example_body <- list(
  a=1,
  b=2,
  c=3
)
#* Example PUT endpoint
#* @serializer unboxedJSON list(na = NULL)
#* @put /my_example
function(req) {
  # 兼容两种请求体格式
  body <- if (!is.null(req$body$body)) req$body$body else req$body
  # 无请求体时使用默认值
  body <- body %||% example_body
  
  print(body)
  result <- body$a + body$b + body$c
  return(result)
}

这种方式去掉了@param body:object的定义，避免Plumber自动注入带来的不一致，所有请求体都通过统一逻辑获取，适用于不想修改全局配置的场景。

方案3：检查Plumber版本与配置 #

部分旧版本的Plumber在Swagger集成中存在请求体嵌套的问题，升级到最新稳定版可能直接解决该问题。同时可以检查Plumber的Swagger配置项，是否有参数能控制请求体的解析方式（比如调整swagger选项的相关参数）。

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