swagger - 在 springfox 3 (swagger) 中，我如何获得对象列表请求体的有用文档？

Question

这似乎是 springfox swagger 的一个非常基本的功能，但我找不到如何使它工作。

我想看到的：

@GetMapping('foos')
public ResponseEntity updateFoo(@RequestBody @Parameter List<Foo> foos) {
// do stuff
}

应该导致类似

"paths": {
  "/foos": {
    (...)
    "parameters": [
      {
        "name": "foo",
        "in": "query",
        "description": "foo",
        "required": false,
        "type": "array",
        "items": {
        "type": "Foo"
      },

但是我得到

"paths": {
  "/foos": {
    (...)
    "parameters": [
      {
        "name": "foo",
        "in": "query",
        "description": "foo",
        "required": false,
        "type": "string"
      }
    },

因此该列表被识别为类型字符串。这意味着对于 swagger 文档的任何读者来说，完全不清楚他们是否真的需要提供特定 foo 对象的列表。

如何让 springfox 为列表制作正确的文档？

编辑：对于这个项目，我们决定转移到 SpringDoc 来规避这个问题。