Spring环境下使用Retrofit2转换curl -F命令的代码错误排查

存在的问题 #

• 1. Retrofit接口方法的@Part注解配置错误
     你当前写的@Part("file\"; filename=\"pp.png\" ")是错误用法，@Part的value只需填写表单字段名即可，filename和Content-Type相关的元数据会由MultipartBody.Part自动封装，不需要手动写在注解参数里。
• 2. 接口参数类型和实际传参不匹配
     你代码中已经构造了正确的MultipartBody.Part类型的filePart参数，但接口定义的参数是RequestBody类型，且你调用时传的是单独构造的fbody而不是已经生成好的filePart，导致表单结构不符合curl的要求。
• 3. 冗余构造RequestBody对象
     你既构造了MultipartBody.Part类型的filePart，又额外构造了RequestBody类型的fbody，属于无用的冗余逻辑。

修复步骤 #

第一步：修正Retrofit接口定义 #

把接口方法改成接收MultipartBody.Part类型的参数，@Part注解不需要填参数：

@Multipart
@POST("v1/metadata/asset")
Call<Asset> getAsset(@Header("Authorization") String authentication, 
                     @Header("x-chain-id") String chainId,
                     @Part MultipartBody.Part file);

第二步：修正传参逻辑 #

删除冗余的fbody构造代码，直接传你已经生成好的filePart即可：

URL url = new URL("你的图片URL");
BufferedImage image = ImageIO.read(url);
File tempFile = new File("你的临时文件路径");
ImageIO.write(image, "png", tempFile);
// 构造MultipartBody.Part参数，表单字段名设置为file，和curl要求一致
MultipartBody.Part filePart = MultipartBody.Part.createFormData("file", tempFile.getName(), 
        RequestBody.create(MediaType.parse("image/png"), tempFile));
// 调用接口时直接传filePart即可
Call<Asset> call = retrofitApi.getAsset("你的API-KEY", "PORT", filePart);

额外注意点 #

• 临时文件使用完后建议手动删除，避免磁盘占用
• 如果你的图片不是固定png格式，建议根据实际图片类型设置MediaType，不要直接写死image/*，避免部分接口校验不通过
• 接口命名建议和请求方式匹配，POST请求不要用get开头，避免后续维护产生歧义
• 确认你的Retrofit已经配置了正确的Call适配器，Spring项目如果用同步调用可以直接用execute()方法执行Call

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