Java Spring Boot中邮件按钮触发文件存删操作的实现问题

邮件中的审批/拒绝按钮本质是HTML链接，无法直接触发本地文件操作，必须通过后端HTTP接口承接点击事件，同时配合临时文件管理与超时机制完成需求。以下是具体实现步骤：

1. 后端接口设计（承接按钮点击事件） #

提供两个GET接口分别处理审批和拒绝请求，通过唯一token关联对应的文件信息，同时处理幂等性与过期校验：

@RestController
@RequestMapping("/approval")
public class ApprovalController {

    @Autowired
    private ApprovalFileService fileService;

    // 审批接口
    @GetMapping("/approve")
    public ModelAndView approve(@RequestParam String token) {
        ApprovalFileMeta meta = fileService.getFileMetaByToken(token);
        if (meta == null || meta.isExpired()) {
            return buildResultView("操作已过期或无效");
        }

        boolean saveSuccess = fileService.moveTempFileToTarget(meta.getTempPath(), meta.getTargetPath());
        if (saveSuccess) {
            fileService.recordOperation(meta.getFileId(), LocalDateTime.now(), ApprovalStatus.APPROVED);
            fileService.invalidateToken(token); // 标记token已使用，防止重复操作
            return buildResultView("审批成功，文件已保存");
        }
        return buildResultView("审批失败，请联系管理员");
    }

    // 拒绝接口
    @GetMapping("/decline")
    public ModelAndView decline(@RequestParam String token) {
        ApprovalFileMeta meta = fileService.getFileMetaByToken(token);
        if (meta == null || meta.isExpired()) {
            return buildResultView("操作已过期或无效");
        }

        boolean deleteSuccess = fileService.deleteTempFile(meta.getTempPath());
        if (deleteSuccess) {
            fileService.recordOperation(meta.getFileId(), LocalDateTime.now(), ApprovalStatus.DECLINED);
            fileService.invalidateToken(token);
            return buildResultView("已拒绝，文件已删除");
        }
        return buildResultView("拒绝操作失败，请联系管理员");
    }

    // 构建结果页面（替代纯文本返回，提升体验）
    private ModelAndView buildResultView(String message) {
        ModelAndView view = new ModelAndView("approval-result");
        view.addObject("message", message);
        return view;
    }
}

2. 邮件按钮与token关联 #

发送邮件时，将按钮链接动态替换为带token的接口地址，示例HTML邮件模板片段：

<div style="margin: 20px 0;">
    <a href="https://your-domain.com/approval/approve?token={{approvalToken}}" 
       style="background: #28a745; color: white; padding: 10px 20px; border-radius: 4px; text-decoration: none;">
        审批通过
    </a>
    <a href="https://your-domain.com/approval/decline?token={{approvalToken}}" 
       style="background: #dc3545; color: white; padding: 10px 20px; border-radius: 4px; text-decoration: none; margin-left: 15px;">
        拒绝申请
    </a>
</div>

发送邮件前，生成唯一token并绑定文件元数据（临时路径、目标路径、过期时间等），存储到Redis并设置过期时间：

@Service
public class ApprovalFileService {

    @Autowired
    private StringRedisTemplate redisTemplate;

    // 生成token并存储文件元数据
    public String generateApprovalToken(String fileId, String tempPath, String targetPath, Duration expireTime) {
        String token = UUID.randomUUID().toString();
        ApprovalFileMeta meta = new ApprovalFileMeta(fileId, tempPath, targetPath, LocalDateTime.now().plus(expireTime));
        redisTemplate.opsForValue().set(token, JsonUtil.toJson(meta), expireTime);
        return token;
    }

    // 根据token获取元数据
    public ApprovalFileMeta getFileMetaByToken(String token) {
        String metaJson = redisTemplate.opsForValue().get(token);
        return metaJson != null ? JsonUtil.fromJson(metaJson, ApprovalFileMeta.class) : null;
    }

    // 标记token已使用
    public void invalidateToken(String token) {
        redisTemplate.delete(token);
    }

    // 其他文件操作与记录方法...
}

// 元数据实体类
@Data
public class ApprovalFileMeta {
    private String fileId;
    private String tempPath;
    private String targetPath;
    private LocalDateTime expireTime;

    public boolean isExpired() {
        return LocalDateTime.now().isAfter(expireTime);
    }
}

3. 超时自动删除实现 #

采用定时任务方案（比Redis过期事件更稳定），定期扫描过期文件并清理：

@Service
public class ExpiredFileCleanupTask {

    @Autowired
    private ApprovalFileService fileService;

    // 每半小时扫描一次过期文件
    @Scheduled(cron = "0 */30 * * * ?")
    public void cleanupExpiredFiles() {
        List<ApprovalFileMeta> expiredMetas = fileService.listExpiredFileMetas();
        for (ApprovalFileMeta meta : expiredMetas) {
            fileService.deleteTempFile(meta.getTempPath());
            fileService.recordOperation(meta.getFileId(), LocalDateTime.now(), ApprovalStatus.EXPIRED);
            fileService.deleteFileMeta(meta.getFileId());
        }
    }
}

4. 关键注意事项 #

• 幂等性：同一token只能执行一次操作，通过删除Redis中的token或标记状态实现。
• 安全性：使用HTTPS链接防止token泄露，可对token进行签名验证避免篡改。
• 反馈优化：点击按钮后跳转至自定义结果页面，而非返回纯文本，提升用户体验。

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