postman-to-k6转换含formdata的Postman集合报path参数类型错误如何解决

首先明确报错核心原因：工具处理formdata文件字段时，预期接收字符串类型的文件路径参数，实际拿到了数组类型值，触发参数校验失败。
可按以下步骤定位具体问题：

• 步骤1：最小场景复现验证
  单独导出仅包含1个文件上传请求的无敏感信息测试集合，使用相同命令转换，确认单文件上传场景是否可以正常转换，排除集合其他逻辑的干扰。
• 步骤2：开启调试日志查看完整调用栈
  运行转换命令前开启调试模式：
  • Windows环境执行：

    set DEBUG=postman-to-k6*
    postman-to-k6 .\collection.JSON -o K6-script.js
    

  • Mac/Linux环境执行：

    DEBUG=postman-to-k6* postman-to-k6 .\collection.JSON -o K6-script.js
    

  输出的调试日志会明确标识出处理到哪一个请求、哪一个字段时触发错误，直接定位异常位置。
• 步骤3：批量扫描集合定位异常字段
  执行以下Node脚本遍历集合所有请求，直接找出多文件配置的formdata字段：

  // 保存为scan.js，放到集合文件同目录下执行
  const collection = require('./collection.JSON');
  function traverse(items, parentPath = '') {
    items.forEach(item => {
      const currentPath = `${parentPath}/${item.name}`;
      // 处理嵌套文件夹
      if (item.item) return traverse(item.item, currentPath);
      // 筛选formdata类型请求
      if (item.request?.body?.mode === 'formdata') {
        item.request.body.formdata.forEach(field => {
          // 检查文件类型字段的src是否为数组
          if (field.type === 'file' && Array.isArray(field.src)) {
            console.log(`异常请求路径：${currentPath}，异常字段名：${field.key}，多文件路径：`, field.src);
          }
        })
      }
    })
  }
  traverse(collection.item);
  

  执行命令：node scan.js即可输出所有异常的请求和字段。
• 步骤4：校验工具版本
  执行npm list -g postman-to-k6查看当前工具版本，若版本低于v1.9.0，执行npm install -g postman-to-k6@latest升级到最新版本后重试，旧版本存在单文件formdata解析错误的已知bug。

90%以上该类报错是因为Postman中单个formdata文件字段选择了多个文件上传，postman-to-k6目前不支持单字段多文件上传配置，将对应字段修改为单文件即可正常转换。

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