Spring Boot文件上传至相对路径问题及代码求助

核心原因 #

Spring Boot会自动校验配置文件中的属性，自定义的upload.directory未被Spring的配置绑定机制识别，因此被标记为未知属性。

解决方案 #

方案1：使用配置属性绑定类（推荐） #

创建配置类，通过@ConfigurationProperties注解绑定自定义属性，让Spring识别该配置：

import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;

@Component
@ConfigurationProperties(prefix = "upload")
public class UploadProperties {
    private String directory;

    // Getter和Setter
    public String getDirectory() {
        return directory;
    }

    public void setDirectory(String directory) {
        this.directory = directory;
    }
}

在业务类中注入该配置类替代Environment：

@Autowired
private UploadProperties uploadProperties;

public String uploadFile(MultipartFile file, MultipartFile qrfile, String name, String type) {
    String directory = uploadProperties.getDirectory();
    // 用Paths拼接路径，自动适配系统路径分隔符
    String filePath = Paths.get(directory, name).toString();
    String qrFilePath = Paths.get(directory, "qr" + name).toString();

    // 保存数据库记录
    SubComponent fileData = fileDataRepository.save(SubComponent.builder()
            .name(name)
            .type(type)
            .filePath(filePath)
            .qrFilePath(qrFilePath)
            .build());

    // 处理主文件存储（先判断非空）
    if (file != null) {
        try {
            file.transferTo(new File(filePath));
        } catch (IllegalStateException | IOException e) {
            e.printStackTrace();
            return "File upload failed";
        }
    }
    // 补充处理二维码文件存储
    if (qrfile != null) {
        try {
            qrfile.transferTo(new File(qrFilePath));
        } catch (IllegalStateException | IOException e) {
            e.printStackTrace();
            return "QR file upload failed";
        }
    }

    return "Uploaded success: " + filePath;
}

方案2：关闭配置属性校验（仅临时调试用） #

若想快速消除提示，可在application.properties中添加配置，让Spring忽略未知属性校验：

spring.config.ignore-invalid-properties=true

此方式会跳过所有无效配置校验，可能隐藏其他配置错误，不建议正式环境使用。

额外优化点 #

• 避免手动拼接路径字符串，用java.nio.file.Paths类拼接，适配不同操作系统的路径分隔符。
• 文件存储前先判断MultipartFile是否非空，防止空指针异常。
• 原代码未处理qrfile的存储逻辑，需补充完善。

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