OpenAPI Generator Java版本变更后生成代码出现语法错误

升级OpenAPI Generator版本后，生成的Java代码中出现非法语法return this =;，错误代码示例：

public CreateUserAccountRequest qradarAllowedDomainIds(List qradarAllowedDomainIds) {
    this.qradarAllowedDomainIds = qradarAllowedDomainIds;
    return this =;
}

public CreateUserAccountRequest addQradarAllowedDomainIdsItem(String qradarAllowedDomainIdsItem) {
        if (this.qradarAllowedDomainIds == null) {
        this.qradarAllowedDomainIds = new ArrayList<>();
        }
    this.qradarAllowedDomainIds.add(qradarAllowedDomainIdsItem);
    return this =;
}

排查与解决步骤 #

• 检查自定义模板文件
  OpenAPI Generator依赖Mustache模板生成代码，若你曾自定义过Java模型相关模板（如pojo.mustache、setter.mustache），版本升级后模板语法可能不兼容，导致残留错误语法。对比官方最新模板，将错误的return this =;修正为return this;。

• 验证OpenAPI Generator版本
  部分版本可能存在此类已知bug，优先尝试：

  • 升级至最新稳定版：执行openapi-generator-cli upgrade更新工具，再重新生成代码
  • 若问题仍存在，降级至之前能正常生成的版本，排查版本变更点，同时查看官方issue列表确认是否有相关bug报告。

• 检查OpenAPI规范文件
  不规范的API定义可能引发生成器解析错误。确认qradarAllowedDomainIds字段的数组类型定义是否标准：

  qradarAllowedDomainIds:
    type: array
    items:
      type: string
  

  修复spec中的语法或定义问题后重新生成。

• 清理缓存重新生成
  生成器可能缓存旧模板或结果，执行以下操作：

  • 使用openapi-generator-cli generate --clean参数清理缓存
  • 删除本地生成的代码目录，重新执行生成命令

修复后正确代码示例 #

public CreateUserAccountRequest qradarAllowedDomainIds(List<String> qradarAllowedDomainIds) {
    this.qradarAllowedDomainIds = qradarAllowedDomainIds;
    return this;
}

public CreateUserAccountRequest addQradarAllowedDomainIdsItem(String qradarAllowedDomainIdsItem) {
    if (this.qradarAllowedDomainIds == null) {
        this.qradarAllowedDomainIds = new ArrayList<>();
    }
    this.qradarAllowedDomainIds.add(qradarAllowedDomainIdsItem);
    return this;
}

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