SoapUI 5.7.0导入Swagger YAML时$ref参数解析失败求助

问题现象 #

导入使用$ref复用参数的OpenAPI 3.0.2 YAML到SoapUI 5.7.0时，抛出以下空指针异常：

java.lang.NullPointerException: Cannot invoke "String.equals(Object)" because the return value of "io.swagger.models.parameters.Parameter.getIn()" is null

该YAML在Swagger编辑器中验证完全有效，核心代码片段如下：

openapi: 3.0.2
info:
  title: REST API
  description: "Test yaml for SoapUI import."
  version: 1.0.0
servers:
- url: /
  description: test
security:
- Auth: []
paths:
  /rest/fcc/users/{id}:
    get:
      tags:
      - FCC users and roles
      summary: Gets user with given id
      description: Returns user with given id.
      parameters:
      - $ref: '#/components/parameters/id'
      responses:
        '200':
          description: Successful opperation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/User_one'
        '404':
          description: Entity with given id does not exist
    delete:
      tags:
      - FCC users and roles
      summary: Deletes user with given id
      description: Removes user with given id.
      parameters:
      - $ref: '#/components/parameters/id'
      responses:
        '204':
          description: Successful deletion
components:
  securitySchemes:
    Auth:
      type: oauth2
      flows:
        password:
          tokenUrl: /resources/oauth/token
          scopes: {}
  parameters:
    id:
      name: id
      in: path
      required: true
      schema:
        type: integer
        example: 2
  schemas:
    User_one:
      type: object

问题根源是SoapUI 5.7.0对OpenAPI 3.x中参数的$ref解析支持不完善，无法正确展开引用导致参数的in属性为null。

解决方案 #

方案1：手动展开参数引用 #

直接将复用的参数内容复制到每个端点的parameters列表中，替换$ref引用。修改后的paths部分示例：

paths:
  /rest/fcc/users/{id}:
    get:
      tags:
      - FCC users and roles
      summary: Gets user with given id
      description: Returns user with given id.
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: integer
            example: 2
      # 其余内容不变
    delete:
      tags:
      - FCC users and roles
      summary: Deletes user with given id
      description: Removes user with given id.
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: integer
            example: 2
      # 其余内容不变

这种方式无需依赖工具，直接修改YAML即可让SoapUI正确识别参数。

方案2：降级为Swagger 2.0格式 #

SoapUI对Swagger 2.0的$ref支持更完善，将OpenAPI 3.x规范转换为Swagger 2.0格式。转换后的完整示例：

swagger: '2.0'
info:
  title: REST API
  description: "Test yaml for SoapUI import."
  version: 1.0.0
host: localhost
basePath: /
securityDefinitions:
  Auth:
    type: oauth2
    flow: password
    tokenUrl: /resources/oauth/token
    scopes: {}
paths:
  /rest/fcc/users/{id}:
    get:
      tags:
      - FCC users and roles
      summary: Gets user with given id
      description: Returns user with given id.
      parameters:
      - $ref: '#/parameters/id'
      responses:
        200:
          description: Successful opperation
          schema:
            $ref: '#/definitions/User_one'
        404:
          description: Entity with given id does not exist
    delete:
      tags:
      - FCC users and roles
      summary: Deletes user with given id
      description: Removes user with given id.
      parameters:
      - $ref: '#/parameters/id'
      responses:
        204:
          description: Successful deletion
parameters:
  id:
    name: id
    in: path
    required: true
    type: integer
    example: 2
definitions:
  User_one:
    type: object

注意调整核心结构：openapi改为swagger: '2.0'，components拆分为parameters和definitions，securitySchemes改为securityDefinitions，同时适配servers为host+basePath。

方案3：使用工具预展开所有$ref #

用OpenAPI工具将所有引用展开，生成完全扁平化的YAML文件后再导入SoapUI。以@redocly/openapi-cli为例：

1. 安装工具：npm install -g @redocly/openapi-cli
2. 执行打包命令：openapi-cli bundle your-spec.yaml --output bundled-spec.yaml
3. 将生成的bundled-spec.yaml导入SoapUI即可。

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