EasyExcel导出文件名编码问题解决方案

在使用阿里巴巴开源的EasyExcel进行文件导出时，开发者可能会遇到文件名前缀自动添加"utf-8''"的问题。这个问题通常出现在浏览器下载场景中，虽然Postman测试显示正常，但前端对接时就会出现异常。

问题现象

当使用以下代码设置响应头时：

fileName = URLEncoder.encode(fileName, "UTF-8").replaceAll("\\+", "%20");
response.setHeader("Content-disposition", "attachment;filename*=utf-8''" + fileName + ".xlsx");

浏览器下载的文件名会包含"utf-8''"前缀，如："utf-8''测试文件.xlsx"。

问题原因

这是由于HTTP响应头中的Content-disposition字段使用了RFC 5987编码规范。该规范要求在非ASCII字符的文件名前添加字符集声明，"utf-8''"正是这种声明的格式。

解决方案

经过验证，可以采用以下改进方案：

String encodeFilename = URLEncoder.encode(fileName, StandardCharsets.UTF_8.toString());
response.setHeader("Content-disposition", "attachment;filename*=utf-8''" + encodeFilename + ".xlsx");

这个方案的关键点在于：

1. 使用StandardCharsets.UTF_8.toString()明确指定编码格式
2. 保持RFC 5987规范要求的"utf-8''"前缀格式
3. 确保文件名部分经过正确的URL编码

技术原理

这种处理方式符合HTTP协议对非ASCII字符文件名的处理规范：

1. "filename*"是RFC 5987定义的特殊参数
2. "utf-8''"前缀声明了后续字符串的编码方式
3. URL编码确保特殊字符能正确传输

最佳实践

对于EasyExcel的文件导出功能，建议：

1. 统一使用UTF-8编码处理文件名
2. 在服务端完成所有编码工作
3. 保持与RFC规范的兼容性
4. 在不同浏览器和客户端进行充分测试

通过这种方式，可以确保文件导出功能在各种环境下都能正常工作，同时保持文件名的正确显示。