swagger-codegen v3生成的multipart-form-data中UploadRequest对象为null问题

我来帮你一步步排查这个问题，从请求格式、框架配置到代码生成几个维度找原因：

1. 先修正请求里的格式错误 #

你发送的请求体里有个明显的拼写错误：

Content_transfer-Encoding: binary

应该改成标准的连字符格式：

Content-Transfer-Encoding: binary

虽然这可能不是JSON参数为空的直接原因，但格式错误会导致服务器解析请求时出现异常，先把这个基础问题解决。

2. 确保JSON参数的请求格式符合规范 #

你的请求里给json字段加了Content-Type: application/json，但要注意两个关键点：

• 这个Content-Type头部必须和Content-Disposition放在同一部分的头部区域，不能分开
• 头部和JSON内容之间必须有一个空行

正确的请求片段应该是这样：

--Boundary_123456789_123456789
Content-Disposition: form-data; name="json"
Content-Type: application/json

{ "documentName": "string", "contentType": "string", "description": "string" }
--Boundary_123456789_123456789

缺少空行是很多multipart请求解析失败的常见原因，框架会把头部和JSON内容当成一段文本，无法识别为JSON对象。

3. 检查JAX-RS框架的Multipart支持配置 #

Swagger Codegen生成的代码依赖JAX-RS的Multipart特性来解析复杂的表单数据，但默认情况下这个特性不会自动注册，需要手动配置：

3.1 添加必要的依赖 #

如果用的是Jersey框架，在build.gradle里添加这两个依赖：

implementation "org.glassfish.jersey.media:jersey-media-json-jackson:${versions.jerseyVersion}"
implementation "org.glassfish.jersey.media:jersey-media-multipart:${versions.jerseyVersion}"

第一个依赖用来处理JSON的序列化/反序列化，第二个是处理multipart请求的核心依赖。

3.2 注册MultipartFeature #

在你的JAX-RS应用配置类中，注册MultiPartFeature：

@ApplicationPath("/api")
public class YourApplication extends ResourceConfig {
    public YourApplication() {
        // 注册multipart处理特性
        register(MultiPartFeature.class);
        // 其他组件注册...
    }
}

没有注册这个Feature的话，服务器无法正确解析multipart中的JSON对象参数，只会把它当成普通的字符串，进而无法转换成UploadRequest对象，导致null。

4. 调整Swagger Codegen的生成参数 #

如果上面的配置都做了还是不行，可以在生成代码时指定使用Jackson来处理JSON，避免默认的解析器不支持：
比如用swagger-codegen-cli生成时添加参数：

swagger-codegen generate -i your-swagger.yaml -l jaxrs -o output-dir --additional-properties useJackson=true

如果是在build.gradle里配置swaggerCodegen任务，也可以把这个参数加进去，确保生成的代码依赖Jackson来解析form-data中的JSON对象。

5. 确认Swagger YAML定义的正确性 #

你的YAML定义里，json字段的required: true已经放在了正确的层级（schema的required数组里），这部分是没问题的，但可以再确认一下，避免层级错误导致生成的代码逻辑异常。

按照上面的步骤逐一排查，应该就能解决UploadRequest对象为null的问题了。

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