Java Azure Functions无法通过Postman Form-data获取正确格式图片

问题根源 #

直接通过HttpRequestMessage<byte[]>获取请求体时，Form-data格式的请求包含了表单边界、字段描述等额外元数据，并非纯图片字节流。保存这些混合数据会导致文件损坏、体积变大，而Binary方式上传的请求体是纯图片字节，因此处理正常。

解决方案 #

修改函数逻辑，解析Form-data请求中的文件部分，提取纯图片字节数据后再进行存储操作：

修改后的完整代码 #

import com.microsoft.azure.functions.*;
import com.microsoft.azure.functions.annotation.*;
import com.microsoft.azure.storage.blob.*;
import java.nio.file.*;
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;
import java.io.ByteArrayInputStream;
import java.util.Optional;
import java.util.UUID;

public class ImageUploadFunction {

    @FunctionName("CreateItemImage")
    public HttpResponseMessage createItemImage(
            @HttpTrigger(name = "request", methods = {HttpMethod.POST}, 
                        route = "menuimage", authLevel = AuthorizationLevel.ANONYMOUS) 
            HttpRequestMessage<Optional<Multipart>> request,
            ExecutionContext context) {

        String connectionString = "keys";
        String containerName = "menuitemimage";
        String localBasePath = "D:/Photo/three/";
        
        try {
            // 解析Multipart请求
            Optional<Multipart> multipart = request.getBody();
            if (!multipart.isPresent()) {
                return request.createResponseBuilder(HttpStatus.BAD_REQUEST)
                        .body("请求不是合法的Form-data格式").build();
            }

            // 获取表单中的文件字段（字段名需与Postman中设置的一致，此处为"file"）
            MultipartFile filePart = multipart.get().getFile("file").orElse(null);
            if (filePart == null) {
                return request.createResponseBuilder(HttpStatus.BAD_REQUEST)
                        .body("Form-data中未找到文件").build();
            }

            // 获取纯图片字节流
            byte[] imageBytes = filePart.getContent();
            if (imageBytes == null || imageBytes.length == 0) {
                return request.createResponseBuilder(HttpStatus.BAD_REQUEST)
                        .body("文件内容为空").build();
            }

            // 获取文件实际ContentType和扩展名
            String contentType = filePart.getContentType();
            String fileExtension = getFileExtension(filePart.getFileName());
            String blobName = UUID.randomUUID().toString() + fileExtension;
            String localPath = localBasePath + blobName;

            // 保存到本地
            Path localFilePath = Paths.get(localPath);
            Files.write(localFilePath, imageBytes);

            // 上传到Blob Storage
            BlobServiceClient blobServiceClient = new BlobServiceClientBuilder()
                    .connectionString(connectionString).buildClient();
            BlobContainerClient containerClient = blobServiceClient.getBlobContainerClient(containerName);
            BlobClient blobClient = containerClient.getBlobClient(blobName);

            ByteArrayInputStream inputStream = new ByteArrayInputStream(imageBytes);
            byte[] md5Hash = calculateMD5Hash(imageBytes);

            BlobHttpHeaders headers = new BlobHttpHeaders()
                    .setContentType(contentType)
                    .setContentMd5(md5Hash);

            blobClient.upload(inputStream, imageBytes.length);
            blobClient.setHttpHeaders(headers);

            context.getLogger().info("图片上传成功，ContentType: " + contentType);
            return request.createResponseBuilder(HttpStatus.OK)
                    .body("图片上传成功，地址：" + blobClient.getBlobUrl()).build();

        } catch (Exception e) {
            context.getLogger().severe("错误：" + e.getMessage());
            return request.createResponseBuilder(HttpStatus.INTERNAL_SERVER_ERROR)
                    .body("上传失败：" + e.getMessage()).build();
        }
    }

    private byte[] calculateMD5Hash(byte[] data) throws NoSuchAlgorithmException {
        MessageDigest md = MessageDigest.getInstance("MD5");
        md.update(data);
        return md.digest();
    }

    private String getFileExtension(String fileName) {
        if (fileName == null || !fileName.contains(".")) {
            return ".jpeg"; // 默认扩展名
        }
        return fileName.substring(fileName.lastIndexOf("."));
    }
}

关键修改说明 #

1. 请求体类型调整：将HttpRequestMessage<byte[]>改为HttpRequestMessage<Optional<Multipart>>，支持解析Form-data格式请求
2. 提取纯图片数据：通过MultipartFile获取表单中的文件部分，确保仅处理图片字节流，排除Form-data的元数据
3. 动态获取文件属性：从MultipartFile中读取实际的ContentType和文件扩展名，避免硬编码导致的格式不匹配
4. 字段名一致性：Postman中Form-data的字段名需与代码中的file保持一致（可根据需求修改）

测试步骤 #

1. 在Postman中选择POST请求，输入函数路由地址
2. 切换到Form-data模式，添加字段名file，类型选择File，选择本地图片文件
3. 发送请求，查看返回结果，同时检查本地路径和Blob Storage中的文件是否正常打开

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