如何在Citrus HTTP响应中发送图片并避免文件损坏？

问题根源 #

Citrus 默认会将资源文件以文本方式读取并转换为字符串，导致二进制图片数据编码错误，最终文件损坏。以下是针对性的解决方法：

方法1：使用BinaryMessagePayloadBuilder加载二进制内容 #

直接通过BinaryMessagePayloadBuilder读取资源的字节流，跳过字符串转换步骤，确保二进制数据完整：

test.$(
    http().server("converterServiceServer")
          .send()
          .response(httpStatus)
          .message()
          .contentType("multipart/form-data; boundary=" + boundary)
          .type(MessageType.BINARY)
          .body(new BinaryMessagePayloadBuilder(new ClasspathResource("response.txt")))
);

方法2：利用Spring MultipartBodyBuilder构造响应体 #

通过Spring的MultipartBodyBuilder自动处理multipart格式构造，直接生成字节数组传入，彻底避免手动格式错误和字符串转换：

import org.springframework.http.client.MultipartBodyBuilder;
import com.fasterxml.jackson.databind.ObjectMapper;

// 构造multipart内容
MultipartBodyBuilder builder = new MultipartBodyBuilder();
// 添加图片part，替换为你的图片资源路径
builder.part("image", new ClasspathResource("sample-image.jpg"))
       .contentType(MediaType.IMAGE_JPEG);
// 若有其他form字段可继续添加
// builder.part("metadata", "image-info");

// 转换为字节数组
byte[] multipartBytes = new ObjectMapper().writeValueAsBytes(builder.build());

test.$(
    http().server("converterServiceServer")
          .send()
          .response(httpStatus)
          .message()
          .contentType("multipart/form-data; boundary=" + builder.getBoundary())
          .type(MessageType.BINARY)
          .body(multipartBytes)
);

额外注意事项 #

• 确保response.txt（或手动构造的multipart文件）是二进制格式保存，避免用文本编辑器打开后重新保存（会引入编码转换）。
• 可配置Citrus日志跳过二进制内容打印，避免日志框架干扰：

  # application.properties
  citrus.logging.message.payload.binary=false
  citrus.logging.message.payload.max-size=-1
  

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