调试 API
如何将 Apifox 项目导入到离线空间里？
导出项目：在Apifox网页端/客户端中，进入 项目设置 > 导出，选择 OpenAPI Spec 格式，导出文件。
导入离线空间：打开离线空间，点击 导入集合 > 选择 OpenAPI(Swagger)文件，选中已导出的文件完成导入。
:::caution[] 注意事项：
...
如何将离线空间里的数据导入到 Apifox 项目里？
目前不支持，离线空间的数据都在你本地项目里，你可以考虑让 AI 整理成通用格式，比如 OpenAPI 格式，就可以导入项目中了。
为什么同样的请求在其它工具（比如 Postman）里能正常工作，但在 Apifox 里却不行？
如果请求完全一样，那不管用什么工具，响应应该都是一样的。如果你发现响应不一样，可以在 Apifox 里切换到 “实际请求” 标签页，对比一下你在其它工具 （比如 Postman） 里发送的请求，看看有什么不同。
Postman 里如何查看实际请求？
发送请求后，点开下方控制台即可查看。
。这是 Node.js 的限制，目前 Apifox 不支持配置修改此限制。如果打印的文件内容过大，超过此限制，就会报错。
如何在接口请求时上传文件？
接口请求需要上传文件，需要将请求的 Body 切换为 form-data 格式，并将对应字段设置成 file 类型，设置后即可上传文件。
![image.png](https://api.apifox.com/api/v1/projects/5097254/resources/496165/ima...
Apifox 中如何设置请求超时时间？
点击 Apifox 页面右上角的 “设置” icon。
在弹出的 “设置” 界面，点击 “通用” 选项，你会在右边的选项卡中看到 “请求超时时间” 的设置，填写即可。超时时间默认为 300000 毫秒（5 分钟），如果 设置为 0，则不限制超时时...
使用 Windows 版本连接 DB2 数据库时报错怎么解决？
Apifox 连接 DB2 数据库时如果出现 Error: The specified module could not be found. 错误，通常是因为缺少必要的环境变量。您可以按照以下步骤配置环境变量来解决这个问题：
配置 PATH 环境变量：将 <Apifox 安装位置>\r...
如何批量修改 Header 的 User-Agent 字段
在根目录新建一个前置操作-自定义脚本，输入以下内容：
pm.request.headers.remove("User-Agent");
pm.request.headers.add({
key: 'User-Agent',
value: 'Chro...
接口带上了非预期的 Cookie 怎么处理？
打开项目内右下角 Cookie 管理
关闭 “启用全局 Cookie”
发送请求失败 “Error: getaddrinfo ENOTFOUND xxx.xxx.xxx.xxx” 的原因及排查方法
Apifox 中遇到 Error: getaddrinfo ENOTFOUND xxx.xxx.xxx.xxx 错误，通常表示 Apifox 无法解析请求中的域名或主机名，或者网络不可达。以下是可能的原因及排查方法：
1. URL 或 IP 地址错误:
仔细检查请求的 URL 或 IP 地址是否拼写...
为什么Web端发送请求正常，客户端发送请求，出现“read ECONNRESET”？
1. Apifox 版本问题--> 升级 Apifox：将 Apifox 更新到最新版本，查看问题是否解决。
2. Apifox 配置问题--> 调整超时时间：在 Apifox 的设置中，适当增加请求的超时时间，避免因连接未及时响应而被重置。--> 检查 SSL 验证：如果目标服务...
使用 Apifox 连接 Oracle 数据库报错 NJS-045?
使用 arm64 系统连接 Oracle 数据库时，出现 “NJS-045: cannot load a node-oracledb binary for Node.js 18.18.2 (darwin arm64)” 错误。目前 Oracle 官方在 ARM64 架构上存在兼容性问题，因此目前 O...
怎么把其它工具的环境迁移到Apifox？
在 Apifox 中，变量的远程值会在团队内同步，而本地值仅存储在本地。这意味着，当你在另一台电脑上使用 Apifox 时，无法访问之前设置的本地值。
为了解决这个问题，Apifox 提供了环境迁移功能。你可以将环境中的服务和变量导出为 JSON 文件，并在另一台电脑上导入。操作步骤如下：
...
为什么 WebSocket 在 web 端连接正常，在客户端报“1006 Abnormal Closure“？
如果 WebSocket 接口可以访问外网，请尝试切换网络，例如使用手机热点。
如果使用手机热点正常，请检查是否开启了代理 网络代理
如果使用手机热点也报错，可能是 Web 端在浏览器中会自动携带一些头信息，您可以打开浏览器的开发者工具（通常是按下 F12 键），手动将浏览器中请求 WebSock...
为什么网络正常，访问 Apifox 提示“连接 Apifox 服务器出错，请检查网络是否异常”？
如果你的网络连接正常，但 Apifox 仍然提示“连接 Apifox 服务器出错”，可能是以下原因导致的：
检查 Apifox 的网络代理设置： Apifox 的网络代理设置可能会干扰与服务器的连接。请检查你的 Apifox 代理设置是否正确，并根据需 要进行调整。详情请查看网络代理文档。
浏览器访...
为什么 curl 请求正常返回 200，但在 Apifox 中请求却返回 400？
如果 curl 请求正常，但在 Apifox 中相同的请求返回 400 错误，很可能是 Apifox 中的请求头设置与 curl 不同导致的。请检查以下几点：
请求头： 切换到 Apifox 的“Header”标签页，确认是否关了几个系统自动生成的 Header。Host头缺失通常会导致 400 ...
为什么在 Apifox 上传文件，后台接收不到？
如果使用 Apifox 上传文件，但是后台接收不到，可以尝试以下步骤进行排查：
验证 Apifox 发送请求是否正确：发送文件到 https://echo.apifox.com/post， 查看返回结果是否包含上传的文件。如果返回结果正确，则说明 Apifox 发送文件没有问题，问题可能出在你的服...
Dubbo 接口调试时出现 "The socket was closed.(address:address=>bolt://{ip})" 错误，如何解决？
当使用 Apifox 调试 Dubbo 接口时，出现 "The socket was closed.(address:address=>bolt://{ip})" 错误，通常表示 协议错误 或 TCP 连接不通。请按照以下步骤排查：
确认 Dubbo 服务端配置： 检查 ...
如何通过本地解压文件的方式添加 Apifox 浏览器插件？
准备插件压缩包：先找到 Apifox 浏览器插件的压缩包（通常为 .zip 格式），将其解压到电脑本地的任意文件夹中。
打开浏览器插件管理页：在浏览器地址栏中输入 chrome://extensions/ 并按下回车键，进入插件管理界面
开启开发者模式：在浏览器插件管理界面的右上角，找到并勾选...
接口签名使用 AES-GCM 加密
内置的 crypto-js 不支持 AES-GCM 加密，使用 jscrypto，参考脚本
fox.liveRequire("jscrypto", (JsCrypto) => {
try {
var key = JsCrypto.Hex.parse("...
前置脚本如何使用 SHA256withRSA 加密？
代码参考：
const rsa = require("jsrsasign");
// 1. 生成或导入一个RSA私钥
var privateKeyPEM = `
-----BEGIN PRIVATE KEY-----
MIIEvwIBADANBgkqhkiG9w0BAQE...
Web端运行接口时，报错提示 Get "http://localhost:3000/test": dial tcp [::1]:3000: connect: connedtion refused
解决方案：安装浏览器扩展
为什么使用 Web 网页端，通过浏览器插件请求 Ollama 部署的大模型会提示 403？
原因
报错 403 是由于 Chrome 插件发送的请求携带 Header 参数 origin: chrome-extension://xxx ，而 Ollama 不支持这个头，导致请求被拒绝。
解决办法
需修改 Ollama 配置以放行 chrome-extension 来源的请求。具体可参照官方...
为什么在 WEB 端中修改 Referer 请求头无效？
1. 为什么在 Apifox Web 端中修改 Referer 请求头无效？
Referer属于浏览器的禁止修改的请求头，受浏览器安全策略限制，前端脚本（如网页代码、浏览器扩展）无法手动修改或覆盖该请求头。这是浏览器为防止跨站请求伪造（CSRF）等安全风险设置的保 护机制。
2. 那如何修改Ref...
接口返回的是 Protobuf 数据，如何正常查看？
可以通过后置脚本结合protobufjs库解析，将二进制Protobuf数据转换为JSON格式，步骤如下：
使用后置脚本加载protobufjs库
引入对应的.proto文件定义
解析接口返回的二进制流数据
示例脚本：
fox.liveRequire("protobufjs"...
接口请求中 Header 携带 Authorization 参数不生效问题
Apifox 中 Authorization 参数未正确带入请求头，可能有以下几种原因：
检查接口及父级目录的 Auth 设置： Apifox 中，接口和父级目录都可以设置 Auth 信息。请检查接口、父级目录、根目录是否设置了与 Header 同名的 Authorization 参数。Auth ...
为什么点击 Body 的自动生成 点击不生效，不更新参数值？
显示如下图所示：
在...
为什么直接使用 Apifox 生成的 curl 运行报 “URL using bad/illegal format or missing URL“ ？
原因：复制出来的 curl 没有自动编码，导致直接使用该 curl 会报错 “URL using bad/illegal format or missing URL”
解决办法：需要手动将 query&path 参数值进行编码：打开 “接口 -> Params -> query&...
Apifox 是否支持 STOMP 协议的 WebSocket 连接？
Apifox 目前暂不支持基于 STOMP 协议的 WebSocket 连接。
在对 STOMP 协议相关的 WebSocket 连接进行技术评估时，我们发现 STOMP 协议在与 WebSocket 结合时存在一些特定的技术挑战。
从协议层面来看，STOMP 是基于帧（Frame）的协议，在与 ...
如何在文件修改后，接口直接读取修改的文件（本地文件路径以变量存储）
:::tip[该问题需要解决两方面的问题]
修改文件内容，不管是 csv 文件或者别的什么，Apifox 不支持直接修改文件内容，但是可以使用外部程序，帮助文档查看 调用外部程序。
想要解放双手，避免手动上传，自动使用本地的文 件，需要使用变量作为中间容器
可以设置在环境变量或者全...
Socket 如何使用 GBK 格式发送数据？
定位到 “项目设置 - 项目资源 - 自定义函数(Socket) - Socket 请求数据处理函数”，添加一个这样的函数:
![image.png](https://api.apifox.com/api/v1/projects/5097254/resources/577360/image-pre...
为什么参数值中的"+"会被解码成空格？
在 URL 编码规则中，表单数据里的空格字符需要编码成 "+"，因为在 URL 中直接使用空格是不安全的。
虽然%20也是空格的 URL 编码形式，但相对来说又长又不容易阅读。所以当 Web 服务器接收并解码 URL 或表单数据时，会把 "+" 解码成空格。这...
如何在自定义脚本中获取变量时，同时替换该变量的变量值中的变量或动态值
:::note[前置]1.变量的变量值，引用了其他变量2.变量的变量值，设置了动态值
基于以上两种场景，直接通过get的方式进行获取时，无法获取到变量值内引用的变量和动态值生成信息
pm.globals.get("aa")
pm.environment.get("aa&...
gRPC 请求报 “Request Exception Received message larger than max” 如何解决？
根据 GRPC Core 文档，看错误码是超过了最大 4M 的限制。
我们目前客户端部分发送和接收对此进行限制，目前没有地方可以设置这块。
数据库连接报错，该如何排查？
先检查第三方数据库连接 GUI 客户端（如 Navicat 等）是否能正常连接。
若客户端连接正常，麻烦提供该客户端数据库连接配置页面截图，便于快速定位问题。
杀毒软件报毒“openapi-generator-cli.jar”如何解决？
这个报毒属于误报，并非病毒。
报毒原因分析
涉及文件： testingAutoload.php（位于 openapi-generator-cli-4.3.1.jar 组件包内）。
技术原理： 该文件属于开源项目 OpenAPI Generator。其包含的 passthru 指令用于测试阶段自...