在Java Web开发中，文件上传是常见功能，默认情况下如果直接使用用户上传的原始文件名保存，很容易出现同名文件覆盖的问题，因此需要在文件保存到磁盘之前完成重命名操作。重命名的核心思路是生成全局唯一的文件名标识，同时保留原文件的后缀，保证文件类型可识别。
文件重命名的实现思路
文件重命名不需要修改文件本身的内容，只需要修改文件保存时的名称即可，核心步骤分为三步：
- 获取用户上传文件的原始文件名，提取文件的后缀部分
- 生成一个全局唯一的字符串作为新的文件名前缀，常用的方式有UUID、时间戳加随机数等
- 将新的文件名前缀和原文件后缀拼接，得到最终的重命名后的文件名
基于Spring Boot的实现示例
Spring Boot中文件上传通常使用MultipartFile接收上传的文件，以下是完整的重命名并保存的实现代码：
1. 工具类：生成重命名后的文件名
首先编写一个工具类，用于生成重命名后的文件名，这里使用UUID作为唯一前缀，同时保留原文件后缀：
import java.util.UUID;
public class FileRenameUtil {
/**
* 生成重命名后的文件名
* @param originalFilename 原始文件名
* @return 重命名后的文件名
*/
public static String renameFile(String originalFilename) {
// 获取文件后缀，如果没有后缀则返回空字符串
String suffix = "";
if (originalFilename != null && originalFilename.contains(".")) {
suffix = originalFilename.substring(originalFilename.lastIndexOf("."));
}
// 生成UUID作为文件名前缀，去掉UUID中的横杠
String prefix = UUID.randomUUID().toString().replace("-", "");
// 拼接得到新文件名
return prefix + suffix;
}
}
2. 文件上传接口实现
在Controller中编写文件上传接口，调用上述工具类完成重命名后保存文件：
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.multipart.MultipartFile;
import java.io.File;
import java.io.IOException;
@RestController
public class FileUploadController {
// 定义文件保存的目录，实际开发中可以从配置文件中读取
private static final String UPLOAD_DIR = "D:/upload/";
@PostMapping("/upload")
public String uploadFile(@RequestParam("file") MultipartFile file) {
// 判断上传的文件是否为空
if (file.isEmpty()) {
return "上传文件不能为空";
}
try {
// 获取原始文件名
String originalFilename = file.getOriginalFilename();
// 调用工具类生成重命名后的文件名
String newFileName = FileRenameUtil.renameFile(originalFilename);
// 创建文件对象，指定保存路径和文件名
File destFile = new File(UPLOAD_DIR + newFileName);
// 判断保存目录是否存在，不存在则创建
File parentDir = destFile.getParentFile();
if (!parentDir.exists()) {
parentDir.mkdirs();
}
// 保存文件，这里就是保存前的重命名生效的时机
file.transferTo(destFile);
return "文件上传成功，重命名后的文件名为：" + newFileName;
} catch (IOException e) {
e.printStackTrace();
return "文件上传失败：" + e.getMessage();
}
}
}
注意事项
在实际开发中还需要注意以下几点：
- 文件保存目录需要有写入权限，否则会出现保存失败的问题
- 如果上传的文件较大，需要在配置文件中设置文件上传的大小限制，避免上传超大文件导致服务异常
- 可以根据业务需求调整文件名的生成规则，比如加入用户ID、业务模块标识等，方便后续文件管理
- 重命名后的文件名如果需要返回给前端，建议同时返回原文件名和重命名后的文件名，方便前端展示
通过上述方式，就可以在Java文件上传保存前完成文件重命名，有效避免文件名冲突的问题，保证文件存储的稳定性和规范性。
Java文件上传文件重命名MultipartFile修改时间：2026-07-18 09:09:19