RestEasy与Wildfly 11中MultipartFormDataInput文件名编码异常求助

针对你在Wildfly 11 + Resteasy-multipart-provider 3.0.24.Final环境下遇到的文件名特殊字符（比如ö）乱码问题，我整理了几个经过验证的可行思路：

1. 手动解析Content-Disposition头，指定UTF-8编码 #

Resteasy默认的文件名解析逻辑可能没有正确处理UTF-8编码的特殊字符，你可以绕过框架的默认解析，直接从原始头信息中提取并解码文件名：

@POST
@Consumes(MediaType.MULTIPART_FORM_DATA)
public Response uploadFile(MultipartFormDataInput input) {
    Map<String, List<InputPart>> uploadForm = input.getFormDataMap();
    List<InputPart> inputParts = uploadForm.get("file_upload");
    
    for (InputPart inputPart : inputParts) {
        // 获取原始Content-Disposition头内容
        String contentDisposition = inputPart.getHeaders().getFirst("Content-Disposition");
        // 提取并解码文件名
        String filename = extractAndDecodeFilename(contentDisposition);
        // 后续文件处理逻辑...
    }
    return Response.ok().build();
}

private String extractAndDecodeFilename(String contentDisposition) {
    if (contentDisposition == null) {
        return null;
    }
    // 匹配filename参数（兼容带/不带引号的格式）
    Pattern filenamePattern = Pattern.compile("filename=\"?([^\"]+)\"?");
    Matcher matcher = filenamePattern.matcher(contentDisposition);
    
    if (matcher.find()) {
        String encodedFilename = matcher.group(1);
        try {
            // 强制用UTF-8解码，解决乱码问题
            return URLDecoder.decode(encodedFilename, "UTF-8");
        } catch (UnsupportedEncodingException e) {
            // 解码失败时返回原始字符串，避免报错
            return encodedFilename;
        }
    }
    return null;
}

2. 升级Resteasy-multipart-provider版本 #

你当前使用的3.0.24.Final版本存在文件名编码处理的bug，后续的3.1.x及以上版本已经修复了这个问题。尝试升级到稳定的新版本，比如3.1.10.Final：

<!-- Maven依赖示例 -->
<dependency>
    <groupId>org.jboss.resteasy</groupId>
    <artifactId>resteasy-multipart-provider</artifactId>
    <version>3.1.10.Final</version>
</dependency>

升级后框架会自动正确解析UTF-8编码的文件名，无需额外手动处理。

3. 在Wildfly配置中强制指定Multipart编码 #

在Wildfly的standalone.xml或domain.xml配置文件中，给Resteasy的MultipartFormDataReader添加UTF-8编码配置：

<subsystem xmlns="urn:jboss:domain:jaxrs:1.0">
    <contexts>
        <context path="/your-api-base-path" />
    </contexts>
    <providers>
        <provider>
            <class>org.jboss.resteasy.plugins.providers.multipart.MultipartFormDataReader</class>
            <properties>
                <property name="charset" value="UTF-8"/>
            </properties>
        </provider>
    </providers>
</subsystem>

这个配置会强制Multipart解析器使用UTF-8编码处理所有表单数据，包括文件名。

验证建议 #

测试时用Döner.png这类带特殊字符的文件，检查提取后的文件名是否正常显示ö，而非乱码��。

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