使用OpenAPI生成Node-Express代码时出现重复导入问题求助

问题原因 #

你的Invites模型两次引用了Invite模型，OpenAPI Generator的默认模板在处理重复依赖时，会为每个引用生成一次导入语句，导致出现重复的import代码。

解决方案 #

方案1：修改OpenAPI Generator模板（推荐） #

通过自定义模板实现导入语句自动去重，从根源解决问题：

1. 导出默认模板骨架
   先把nodejs-express-server的默认模板导出到本地，方便修改：

   java -jar ./cgen/openapi-generator-cli.jar meta -o ./cgen/nodejs-express-template -g nodejs-express-server
   

2. 定位模型模板文件
   在导出的模板目录中，找到处理mongoose模型的模板文件（通常位于src/main/resources/handlebars下，文件名可能是Model.mustache或mongooseSchema.mustache）。

3. 修改导入逻辑
   找到模板中生成导入语句的循环代码块，通常是：

   {{#imports}}
   import { {{importSchema}}, {{importInterface}} } from '#models/{{importModel}}';
   {{/imports}}
   

   将其修改为使用unique helper去重：

   {{#unique imports}}
   import { {{importSchema}}, {{importInterface}} } from '#models/{{importModel}}';
   {{/unique}}
   

4. 用自定义模板重新生成代码
   更新生成脚本，指定自定义模板目录：

   java -jar ./cgen/openapi-generator-cli.jar generate -g nodejs-express-server -i ./schemas/index.yaml -c ./cgen/generator_custom_templates/config.yaml -t ./cgen/nodejs-express-template/src/main/resources/handlebars -o ./generated_code --skip-operation-example
   

方案2：生成后用脚本自动清理 #

如果不想修改模板，可以在代码生成完成后，用脚本批量去除重复导入：

1. 创建清理脚本（clean-duplicate-imports.js）

   const fs = require('fs');
   const path = require('path');
   
   function cleanFileImports(filePath) {
     let content = fs.readFileSync(filePath, 'utf8');
     const importRegex = /import\s*{[^}]+}\s*from\s*['"][^'"]+['"];/g;
     const uniqueImports = [...new Set(content.match(importRegex) || [])];
     const contentWithoutImports = content.replace(importRegex, '').trim();
     const cleanedContent = [...uniqueImports, '', contentWithoutImports].join('\n');
     fs.writeFileSync(filePath, cleanedContent);
   }
   
   // 处理目标文件
   cleanFileImports(path.join(__dirname, './generated_code/models/invites.ts'));
   // 如有其他文件需要处理，可继续添加调用
   

2. 整合到生成流程
   修改执行步骤，先生成代码再运行清理脚本：

   java -jar ./cgen/openapi-generator-cli.jar generate -g nodejs-express-server -i ./schemas/index.yaml -c ./cgen/generator_custom_templates/config.yaml -o ./generated_code --skip-operation-example && node clean-duplicate-imports.js
   

方案3：检查Schema定义（可选） #

确认你的Schema没有冗余定义。当前Invites的结构是合理的，但如果业务允许，可尝试调整引用方式（比如用数组替代重复字段），但不推荐为了代码生成而修改业务逻辑相关的Schema。

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