Spring Boot+Thymeleaf无法显示static文件夹图片问题求助

核心问题 #

1. 数据类型不匹配：Controller返回的是List<String>，但Thymeleaf模板中试图访问picDto.URL属性（String类型无URL字段），导致路径解析失败。
2. 路径映射可能偏差：需确认图片存储路径与模板访问路径是否对应。

具体修复步骤 #

1. 修正数据传输对象（DTO） #

创建包含URL字段的DTO类，让Controller传递的数据能被Thymeleaf正确解析：

public class PicDto {
    private String URL;

    // Getter和Setter方法
    public String getURL() {
        return URL;
    }

    public void setURL(String URL) {
        this.URL = URL;
    }
}

2. 调整Controller代码 #

将返回的列表类型改为List<PicDto>，同时确保Service层返回对应类型的对象：

Map<String, Object> paramMap = new HashMap<>();
int hotel_id = 1;
String type = "title";
paramMap.put("hotel_id", hotel_id);
paramMap.put("type", type);

// 修改列表类型为List<PicDto>
List<PicDto> hotelTitle = paymentService.searchHotelTitle(paramMap);

mav.addObject("hotelTitle", hotelTitle);

注意：需同步调整paymentService.searchHotelTitle方法，使其返回List<PicDto>，且每个对象的URL字段存储图片文件名（如1_title.png）。

3. 验证图片存储路径 #

确认图片文件存放在项目的src/main/resources/static/payment/目录下，因为Thymeleaf的@{/payment/${picDto.URL}}会映射到该目录。若图片直接放在static根目录，需将模板路径改为@{/${picDto.URL}}。

4. 检查路径拼写与大小写 #

确保picDto.URL中的文件名（含后缀）与实际图片文件名完全一致（Linux环境下需注意大小写区分）。

5. 确认静态资源配置（可选） #

若项目自定义了WebMvc配置，需保证未覆盖默认静态资源映射。如有自定义配置，添加以下代码确保静态资源可访问：

@Configuration
public class WebMvcConfig implements WebMvcConfigurer {
    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("/**")
                .addResourceLocations("classpath:/static/");
    }
}

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