Karate测试框架中带动态文件名的文件上传异常排查

问题描述 #

使用Karate框架编写API文件上传测试时，已成功将原始Excel文件复制到临时目录并生成唯一文件名，但执行multipart file上传步骤时出现文件找不到异常，尽管文件实际存在于指定路径。

核心问题分析 #

问题出在multipart file的变量引用方式：Karate中在JSON-like对象结构里，#(variable)的字符串替换语法不适用于read字段，Karate需要直接获取路径变量的实际值而非替换后的字符串。此外，硬编码路径分隔符可能引发跨平台兼容性问题。

修复方案 #

1. 修正Multipart File的变量引用 #

将read: '#(newFilePath)'改为直接引用变量名，filename字段同理，无需字符串替换语法：

And multipart file file = { read: newFilePath, filename: newFileName, contentType: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' }

2. 优化路径构建（跨平台兼容） #

避免硬编码路径分隔符，改用Paths.get()统一构建路径，确保在Windows和Linux/macOS下都能正常工作：

# 替换原路径设置代码
* def originalFilePath = Paths.get(projectDir, 'src', 'test', 'resources', 'testdata', 'sample.xlsx').toString()
* def targetDir = Paths.get(projectDir, 'src', 'test', 'resources', 'testdata', 'temp').toString()

3. 添加文件存在性验证（可选） #

在上传前添加断言，确认临时文件已成功创建，便于快速排查问题：

* def fileExists = Files.exists(Paths.get(newFilePath))
* match fileExists == true

完整修复后的代码 #

Feature: File Upload Endpoint with Dynamic File Name

Background:
* def UUID = Java.type('java.util.UUID')
* def Files = Java.type('java.nio.file.Files')
* def Paths = Java.type('java.nio.file.Paths')
* def StandardCopyOption = Java.type('java.nio.file.StandardCopyOption')
* def System = Java.type('java.lang.System')

# Function to generate a unique file name
* def generateUniqueFileName =
  """
  function() {
    var uuid = UUID.randomUUID().toString();
    return 'sample_' + uuid + '.xlsx';
  }
  """

# Function to copy file with a new name to a specific directory
* def copyFileWithNewName =
  """
  function(sourcePath, targetDir, newFileName) {
    var sourceFile = Paths.get(sourcePath);
    var targetPath = Paths.get(targetDir, newFileName);
    Files.createDirectories(targetPath.getParent());
    Files.copy(sourceFile, targetPath, StandardCopyOption.REPLACE_EXISTING);
    return targetPath.toString();
  }
  """

# Set up paths (跨平台兼容写法)
* def projectDir = System.getProperty('user.dir')
* def originalFilePath = Paths.get(projectDir, 'src', 'test', 'resources', 'testdata', 'sample.xlsx').toString()
* def targetDir = Paths.get(projectDir, 'src', 'test', 'resources', 'testdata', 'temp').toString()

# Generate a new file name and copy the file
* def newFileName = generateUniqueFileName()
* def newFilePath = copyFileWithNewName(originalFilePath, targetDir, newFileName)
* print 'New file created at:', newFilePath

# 验证文件存在
* def fileExists = Files.exists(Paths.get(newFilePath))
* match fileExists == true

Scenario: Upload an Excel file
Given url 'http://localhost:8080/upload/file'
And multipart file file = { read: newFilePath, filename: newFileName, contentType: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' }
When method post
Then status 202
And match response == 'File uploaded successfully'

# Clean up: delete the temporary file
* eval Files.deleteIfExists(Paths.get(newFilePath))
* print 'Temporary file deleted:', newFilePath

额外注意事项 #

• 确保临时目录具备读写权限，避免文件复制或删除失败
• src/test/resources下的临时文件不会被Maven/Gradle打包，无需担心版本控制问题
• 可考虑用Karate的After钩子替代当前的清理步骤，确保无论测试成功或失败都能执行清理

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