Spring Boot下载Zip文件遇权限错误：AccessDeniedException

核心错误原因 #

你存在两个关键问题：

1. 路径指向错误：代码中FileSystemResource("./")指向的是当前工作目录，而非你要下载的myarchive.zip文件。操作系统不允许将目录当作可下载的文件流返回，这直接触发了AccessDeniedException（目录的访问权限逻辑和文件完全不同）。
2. 逻辑矛盾：响应头中声明要下载的是myarchive.zip，但实际返回的是目录资源，二者完全不匹配。

解决方案 #

1. 修正文件路径 #

将FileSystemResource的路径改为具体的zip文件路径：

• 若文件在项目当前工作目录下，使用"./myarchive.zip"
• 若使用绝对路径（生产环境更可靠，避免工作目录变化引发问题），比如"E:/your-project-dir/myarchive.zip"（Windows下用正斜杠或双反斜杠\\）

2. 添加文件存在性校验 #

提前检查文件是否存在且可读，避免后续出现无意义的权限或不存在错误。

修正后的代码示例 #

@PostMapping("/download") // 修正原拼写错误：downlode → download
public ResponseEntity<FileSystemResource> generator(@RequestBody Input input)
        throws IOException, JSONException, InterruptedException {
    
    // 改为具体的zip文件路径
    String zipFilePath = "./myarchive.zip";
    File zipFile = new File(zipFilePath);
    
    // 校验文件状态
    if (!zipFile.exists() || !zipFile.canRead()) {
        throw new FileNotFoundException("目标文件不存在或无读取权限：" + zipFilePath);
    }

    FileSystemResource fileResource = new FileSystemResource(zipFile);
    HttpHeaders headers = new HttpHeaders();
    headers.setContentType(MediaType.APPLICATION_OCTET_STREAM);
    String filename = "myarchive.zip";
    headers.setContentDisposition(ContentDisposition.attachment().filename(filename).build());
    headers.setContentLength(fileResource.contentLength());
    
    return ResponseEntity.ok().headers(headers).body(fileResource);
}

额外注意事项 #

• 检查进程权限：确保运行Spring Boot应用的用户对目标zip文件所在目录有读取权限（Windows可通过右键文件→属性→安全选项卡配置）。
• 避免硬编码路径：生产环境建议通过配置文件（如application.properties）注入路径，比如file.download.path=E:/data/myarchive.zip，再用@Value注解读取，提升灵活性。

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