如何修改Java REST API实现GCS文件直接返回无需本地下载？

完全可以跳过本地文件的创建，直接从Google Cloud Storage（GCS）读取文件流并返回给客户端，这样既节省容器磁盘空间，也能提升大文件传输的效率。

修改后的代码 #

@GetMapping(path = "/file", produces = MediaType.APPLICATION_OCTET_STREAM_VALUE)
public ResponseEntity<InputStreamResource> getSpecificFile(@RequestParam String fileName,
        @RequestParam String bucketName, @RequestParam String projectName) {
    Storage storage = StorageOptions.newBuilder().setProjectId(projectName).build().getService();
    Blob blob = storage.get(bucketName, fileName);
    
    if (blob == null || !blob.exists()) {
        return ResponseEntity.notFound().build();
    }

    // 直接从Blob获取输入流，无需本地文件中转
    try (InputStream inputStream = blob.getContent()) {
        String contentType = blob.getContentType();
        // 若元数据无ContentType，设置默认值
        if (contentType == null) {
            contentType = MediaType.APPLICATION_OCTET_STREAM_VALUE;
        }

        return ResponseEntity.ok()
                .contentType(MediaType.valueOf(contentType))
                .header("Content-Disposition", "attachment; filename=\"" + fileName + "\"")
                .body(new InputStreamResource(inputStream));
    } catch (IOException e) {
        e.printStackTrace();
        return ResponseEntity.internalServerError().build();
    }
}

关键优化说明 #

• 直接读取GCS流：通过blob.getContent()直接获取文件输入流，彻底跳过本地文件的写入、读取、删除流程，避免磁盘IO开销和容器磁盘占用问题
• 从元数据取ContentType：使用blob.getContentType()从GCS文件元数据中获取内容类型，比本地文件探测更可靠，也无需依赖本地文件
• 简化资源管理：用try-with-resources自动管理输入流的关闭，无需手动清理本地文件
• 增加存在性校验：提前判断Blob是否存在，及时返回404，避免后续空指针异常

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