Spring Boot如何访问Google Cloud Storage存储桶内的静态资源文件？

1. 直接通过gs://路径访问指定文件（无需遍历存储桶） #

你完全可以直接通过完整的gs://路径加载指定文件，不需要遍历整个存储桶的所有文件。Spring Cloud GCP 默认已经实现了 GCS 资源的加载适配，直接使用ResourceLoader即可动态加载任意路径的文件：

import org.springframework.core.io.Resource;
import org.springframework.core.io.ResourceLoader;
import org.springframework.stereotype.Component;

@Component
public class GcsResourceService {
    private final ResourceLoader resourceLoader;

    public GcsResourceService(ResourceLoader resourceLoader) {
        this.resourceLoader = resourceLoader;
    }

    public Resource getGcsFile(String bucketName, String filePath) {
        // 直接构造gs路径加载对应资源，不会遍历桶内文件
        return resourceLoader.getResource(String.format("gs://%s/%s", bucketName, filePath));
    }
}

也可以直接使用 GCS 原生客户端的get方法直接查询指定文件，性能更高，和桶内文件数量无关：

import com.google.cloud.storage.Blob;
import com.google.cloud.storage.Storage;
import org.springframework.stereotype.Component;

@Component
public class GcsService {
    private final Storage storage;
    private final String bucketName = "你的存储桶名称";

    public GcsService(Storage storage) {
        this.storage = storage;
    }

    public Blob getGcsBlob(String filePath) {
        return storage.get(bucketName, filePath);
    }
}

2. 静态资源自动映射配置用法 #

spring.web.resources.static-locations是Spring MVC自带的静态资源映射配置，配置为GCS路径后，无需自己写代码就可以对外提供静态资源访问服务：

1. 把配置中的通配符替换为你的实际存储桶名称即可，比如你的存储桶名为static-resource-bucket，配置修改为：

spring.web.resources.static-locations=gs://static-resource-bucket/

2. 配置完成后，用户访问你服务的静态资源路径时，Spring会自动到对应GCS桶内拉取文件返回。比如用户访问https://你的域名/images/avatar.png，Spring会自动去GCS桶里查找images/avatar.png文件返回。

3. REST控制器根据文件名获取文件的实现示例 #

下面是完整的控制器实现，包含路径安全校验、404处理、响应头适配：

import com.google.cloud.storage.Blob;
import org.springframework.http.HttpHeaders;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@RequestMapping("/gcs-files")
public class GcsFileController {
    private final GcsService gcsService;

    public GcsFileController(GcsService gcsService) {
        this.gcsService = gcsService;
    }

    @GetMapping("/{filePath:.+}")
    public ResponseEntity<byte[]> getFile(@PathVariable String filePath) {
        // 路径安全校验，防止路径遍历攻击
        if (filePath.contains("..") || filePath.startsWith("/")) {
            return ResponseEntity.badRequest().build();
        }
        Blob blob = gcsService.getGcsBlob(filePath);
        if (blob == null || !blob.exists()) {
            return ResponseEntity.notFound().build();
        }
        HttpHeaders headers = new HttpHeaders();
        // 自动设置正确的Content-Type
        headers.set(HttpHeaders.CONTENT_TYPE, blob.getContentType());
        return new ResponseEntity<>(blob.getContent(), headers, HttpStatus.OK);
    }
}

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