Spring Boot启用SSL后无法通过HTTPS提供图片服务求助

服务器/media/uploads文件夹中存储了图片，通过Spring Boot的Controller提供访问服务，HTTP协议下一切正常，但启用SSL后/image/{name}端点完全无法通过HTTPS访问，站点其他功能正常但无法加载这些图片。

Controller代码如下：

@GetMapping("/image/{name}")
fun getImage(@PathVariable name: String): ResponseEntity<Resource> {
    val path = Paths.get("$PATH/$name")
    val resource = UrlResource(path.toUri())

    return ResponseEntity.ok().contentType(MediaType.IMAGE_JPEG).body(resource)
}

application.properties配置：

server.port=443
server.ssl.key-store=/root/foto/certificate.pfx
server.ssl.key-store-password=***
server.ssl.keyStoreType=PKCS12

已尝试方案：

• 保留HTTP提供图片服务，但HTTPS站点内的HTTP请求被浏览器拦截
• 同时启用HTTP和HTTPS服务，问题仍未解决

1. 替换资源加载方式 #

UrlResource在HTTPS环境下处理本地文件可能存在协议适配问题，建议替换为FileSystemResource直接基于文件系统加载资源，避免URL转换的潜在异常：

val resource = FileSystemResource(path.toFile())

2. 验证SSL配置与权限 #

• 检查证书文件/root/foto/certificate.pfx的权限，确保Spring Boot进程有读取权限，可执行chmod 644 /root/foto/certificate.pfx调整权限
• 确认443端口未被其他进程占用，执行netstat -tulpn | grep 443排查端口占用情况，保证Spring Boot独占该端口

3. 排查安全框架拦截 #

若项目使用Spring Security或其他安全组件，需确认是否对HTTPS请求下的图片路径做了拦截，可临时添加放行规则：

// Spring Security示例配置
@Override
protected void configure(HttpSecurity http) throws Exception {
    http.authorizeRequests()
        .antMatchers("/image/**").permitAll()
        .anyRequest().authenticated();
}

4. 调试请求与资源状态 #

在Controller中添加日志或调试逻辑，确认HTTPS请求是否到达端点、文件是否存在：

@GetMapping("/image/{name}")
fun getImage(@PathVariable name: String): ResponseEntity<Resource> {
    val path = Paths.get("$PATH/$name")
    val file = path.toFile()
    if (!file.exists()) {
        // 记录文件不存在日志
        return ResponseEntity.notFound().build()
    }
    val resource = FileSystemResource(file)
    return ResponseEntity.ok()
        .contentType(MediaType.IMAGE_JPEG)
        .body(resource)
}

通过日志确认请求链路是否正常，以及文件能否被正确读取

5. 检查页面资源请求协议 #

确保页面中图片的请求URL使用HTTPS协议或相对路径，避免硬编码HTTP地址导致的混合内容拦截（即使请求端点是HTTPS，页面中的硬编码HTTP地址仍会被浏览器拦截）

内容的提问来源于stack exchange，提问作者Lukas Altmann