Apifox接口测试必须通过CLI调用云端测试计划URL，不可执行本地JSON文件；需安装≥v1.12.0的apifox-cli（Node.js≥v16.14.0），获取72小时内有效的运行URL，支持直接运行、参数分离或环境变量方式触发，并通过--report-json导出JUnit兼容报告。
要在CI/CD流水线中自动运行Apifox接口测试用例，必须通过Apifox CLI调用云端测试计划，本地无法直接执行导出的JSON测试文件——因为CLI不解析本地JSON，只认Apifox平台生成的唯一运行URL。
安装与验证CLI环境
打开终端，执行 npm install -g apifox-cli 全局安装工具。安装完成后运行 apifox --version，确认输出版本号且不低于 v1.12.0。
【Node.js 版本必须 ≥ v16.14.0】 低于此版本会导致 token 自动刷新失败或签名计算异常，建议使用 nvm 管理多版本并切换至 LTS（如 v18.x）。
执行 npm list -g apifox-cli 查看是否已成功安装在全局路径下，若提示“empty”，说明未安装成功或权限被拒绝，需加 sudo（macOS/Linux）或以管理员身份运行 PowerShell（Windows）重试。
获取测试用例的运行URL
登录 Apifox Web 控制台 → 进入目标项目 → 左侧导航栏点击「自动化测试」→ 找到要集成的测试场景或单接口用例 → 点击右侧「⋯」→ 选择「持续集成」。
在弹出窗口中点击「新建」→ 填写名称（如 ci-prod-login-test）→ 选择运行环境（务必与测试目标一致）→ 设置循环次数、线程数等参数 → 点击「保存」。
保存后，页面会自动生成一条形如 https://run.apifox.cn/xxxxx?token=yyyyy 的 URL，【此URL含短期时效 token，72 小时内有效，不可截图长期复用】。
命令行触发测试执行
方法一：直接运行（适合调试）
在终端中粘贴完整 URL 并执行：apifox run "https://run.apifox.cn/xxx?token=yyy"
方法二：分离参数（适合脚本化）
将 URL 拆为两部分：apifox run --url https://run.apifox.cn/xxx --token yyy
方法三：从环境变量注入（推荐用于 Jenkins/GitLab CI）
先设置：export APIFOX_RUN_URL="https://run.apifox.cn/xxx" 和 export APIFOX_RUN_TOKEN="yyy"，再执行：apifox run --url $APIFOX_RUN_URL --token $APIFOX_RUN_TOKEN。
执行后终端实时输出请求日志、断言结果与汇总统计；若某步骤失败，会明确标出失败接口名及断言错误详情，无需打开网页查看。
解析并提取测试结果
添加 --report-json ./report.json 参数，即可将完整执行结果（含每个步骤耗时、状态码、断言通过率、错误堆栈）导出为标准 JSON 文件。
该 JSON 结构兼容 JUnit XML 格式，可直接被 Jenkins 的 JUnit 插件解析，生成可视化趋势图与失败明细。
注意：若未加 --report-json，CLI 默认仅输出控制台日志，【不会自动生成任何本地报告文件】，CI 流水线中必须显式声明导出路径。
执行完成后检查 report.json 是否生成且非空；若文件为空或报错 “EACCES: permission denied”，说明当前用户无写入权限，需改用绝对路径如 /tmp/apifox-report.json 或提前创建目录并赋权。
