Apifox 8 月更新｜新增测试用例、支持自定义请求示例代码、提升导入/导出 OpenAPI/Swagger 数据的兼容性

Apifox 作为全能 API 工具，正以迅猛之势革新开发者的工作方式！想象一下，您正为测试用例编写头疼，或因 OpenAPI 文件导入失败而延误项目，而 Apifox 8 月更新却带来“救命稻草”：新增测试用例功能、自定义请求示例代码，以及对 OpenAPI/Swagger 兼容性的重大提升！这些更新不仅让 API 开发更高效，还助力团队协作无障碍。然而，若不熟悉新功能，效率提升可能打折扣。今天，我们为您献上一份 Apifox 8 月更新详解指南，从功能解析到实战案例，带您全面掌握这波技术红利！

作为接口管理与测试领域的“全能选手”，Apifox 每一次更新都在解决测试人员和开发人员的真实痛点。8 月版本可谓亮点满满：

• 测试用例功能上线，测试场景更灵活

• 请求示例代码可自定义，提升协作效率

• OpenAPI/Swagger 数据导入导出兼容性增强，企业级接口协同更顺畅

今天，就带你逐条拆解这些更新，看看能给我们的研发流程带来哪些“质变”。

Apifox 新版本上线啦！

看看本次版本更新主要涵盖的重点内容，有没有你所关注的功能特性：

• 支持为接口创建「测试用例」

• 「在线文档」支持更多个性化配置

  • 支持自定义请求示例代码

  • 支持自定义首页

• 支持自动备份每个模块对应的 OpenAPI/Swagger 文件到 GitLab 仓库

• 支持一次性导入 Postman 多个 Collection (dump data)

• 提升导入/导出 OpenAPI/Swagger 数据的兼容性

• 用户反馈优化

  • 解决当数据模型中的数组元素引用数据模型本身时，接口文档无法正常预览的问题

  • 解决下载返回的响应时，文件扩展名不正确的问题

  • 解决数据库连接配置中如果使用了名称包含大写字母的变量，就无法正常连接的问题

  • 解决无法使用 SSH 隧道连接启用了 SSL 的 MySQL、PostgreSQL 数据库的问题

将 Apifox 更新至最新版，一起开启全新体验吧！

 下载 Apifox 最新版

支持为接口创建「测试用例」

Apifox 新增「测试用例」功能，帮助用户更好的进行单接口测试。在接口详情页中可以创建和管理多个测试用例，每个测试用例代表一组特定的请求参数值，覆盖不同的请求场景。用户可一键运行所有测试用例并查看测试报告，快速验证接口在各种请求情况下的行为是否符合预期，提高测试效率，帮助团队更全面评估接口质量，增强接口测试的系统性和全面性。

更多关于测试用例的内容，可以查看帮助文档中的「接口测试用例」部分。

「在线文档」支持更多个性化配置

支持自定义请求示例代码

发布 API 在线文档时，支持配置是否展示自动生成的请求代码。用户可以自行选择需要自动生成的语言或类库，并支持自定义代码内容，使 API 文档更贴合团队的开发规范与偏好。

设置路径：项目设置 -> 通用设置 -> 功能设置 -> 接口功能设置 -> 请求示例代码

支持自定义首页

在线文章新增「自定义首页」功能，支持使用 Markdown 或通过 HTML 配合 CSS 和 JavaScript 打造个性化的 API 文档入口页面，让团队能够创建更专业、更具特色的文档首页，充分体现团队特色和品牌形象。

支持自动备份每个模块对应的 OpenAPI/Swagger 文件到 GitLab 仓库

更新至最新版的 Apifox 后，支持将各个模块的 OpenAPI/Swagger 文件自动备份到 GitLab 仓库，为 API 文档提供了更高效的版本控制和备份机制，使团队能够轻松将接口文档集成到 GitLab 的代码管理工作流，便于更好地掌控 API 规范。

支持一次性导入 Postman 多个 Collection (dump data)

优化了 Postman 数据导入功能，支持一次性导入多个 Collection（dump data），每个 Collection 自动转换为 Apifox 中的「模块」。实现高效数据批量迁移，节省大量时间并确保数据迁移的完整性和准确性。

提升导入/导出 OpenAPI/Swagger 数据的兼容性

Apifox 对 OpenAPI/Swagger 数据的导入导出兼容性方面进行了优化，并解决了与多模块相关的一些问题：

• 修复 requestBody 的 content 为空对象时，出现Cannot read properties of undefined (reading: 'schema')报错且无法导入的问题

• 修复在请求 Body 的字段名引用了数据模型的接口，导出后 Body 内没有任何字段的问题

• 修复接口根目录的前后置操作丢失的问题，确保重要的操作配置得以完整保留

• 当导入接口的 Security 为 JWT Bearer 时，调试此类接口时可以直接输入 Token，而不是通过填写密钥、Payload 等内容生成 Token

• 如果跨模块引用了组件，导出模块数据时，引用的组件也会被同时导出，确保导出数据的完整性和可用性

我们将继续优化 OpenAPI/Swagger 数据的导入导出功能，致力于为用户提供更加标准、易用的使用体验。

用户反馈优化

解决当数据模型中的数组元素引用数据模型本身时，接口文档无法正常预览的问题

最新版本的 Apifox 修复了数据模型中的数组元素自引用导致接口文档无法正常预览的问题，确保接口文档可以清晰完整地展示嵌套的数据模型，提升文档的兼容性和可读性。

解决下载返回的响应时，文件扩展名不正确的问题

我们修复了下载返回的响应时可能会出现扩展名不正确的问题，确保下载文件格式与实际内容一致，进一步提升了用户体验。

解决数据库连接配置中如果使用了名称包含大写字母的变量，就无法正常连接的问题

我们修复了因数据库连接配置中使用包含大写字母的变量名称而导致无法正常连接的问题，确保变量命名不再影响数据库连接的正常建立，提升连接的稳定性和可靠性。

解决无法使用 SSH 隧道连接启用了 SSL 的 MySQL、PostgreSQL 数据库的问题

我们已修复此前无法通过 SSH 隧道连接启用了 SSL 的 MySQL 和 PostgreSQL 数据库的问题，为数据库访问场景提供了更完善的支持，使数据库连接更加安全和可靠。

了解更多

当然，Apifox 产品团队为大家带来的新功能远不止上方这些：

• 解决当 gRPC 的不同 Package 拥有同名的 Service 或 Message 时，通过 gRPC 服务器反射导入的接口无法调试的问题

• 解决数据库操作中无法连续使用多条 SET 语句的问题

• 模块页面会显示模块变量的数量

• 导入数据到模块后，不再会自动创建根目录

• 支持导入较大的 Postman Collection

• 切换响应 Body 的展示模式后，再次发送请求，该模式不会被重置为 「Pretty」

• 测试场景会记住上次保存的「运行于」设置

• 解决自托管 Runner Mock 无法运行新创建的模块内接口的问题

• 解决调整了接口文档内响应体的顺序后，Mock Server 没有返回第一个响应体的问题

• 解决当接口的鉴权方式为「继承」时，无法将鉴权凭证切换为「手动设置」的问题

• 解决使用快捷请求时，如果响应内容是图片，继续请求其他图片后，预览始终展示首张图片的问题

• 解决无法编辑实际请求 Tab 的请求代码的问题

• 解决运行测试场景时，如果接口响应较大，界面卡顿的问题

• 解决导入 Postman Collection 为新模块时，模块名称不正确的问题

除了以上功能，我们也对产品其他细节和使用体验进行了优化，具体修改内容可点击「阅读原文」前往 Apifox 更新日志查看。