Spring Boot REST API中资源部分创建时应返回何种HTTP状态码？

我开发的注册接口逻辑如下：接收POST请求创建新用户，同时调用另一个微服务为该用户创建钱包。当用户和钱包都创建成功时，返回HTTP 201状态码；但当用户创建成功、钱包创建失败时，不确定应该返回哪种状态码。

我查阅资料时发现关于HTTP 207 MULTI-STATUS的观点存在矛盾，核心顾虑是207是WebDAV专用状态码，在普通REST场景下有兼容性局限。

@PostMapping("/register")
public ResponseEntity<User> saveUser(@RequestBody User user) {
    user.setUserId(sequenceGeneratorService.generateSequence(User.SEQUENCE_NAME));
    user.getRoles().forEach(role -> role.setRoleId(sequenceGeneratorService.generateSequence(Role.SEQUENCE_NAME)));

    User savedUser = userService.saveUser(user);
    ResponseEntity<Wallet> createdWallet = createUserWallet(savedUser);
    if (createdWallet.getStatusCode().is2xxSuccessful()) {
        savedUser.setWallet(createdWallet.getBody());
        return new ResponseEntity<User>(savedUser, HttpStatus.CREATED);
    } else {// 此处存疑
        return new ResponseEntity<User>(savedUser, HttpStatus.MULTI_STATUS);
    }
}

private ResponseEntity<Wallet> createUserWallet(User savedUser) {
    Wallet userWallet = Wallet.builder()
            .walletId(sequenceGeneratorService.generateSequence(Wallet.SEQUENCE_NAME))
            .userId(savedUser.getUserId())
            .balance(BigDecimal.ZERO).build();
    return walletServiceProxy.createWallet(userWallet);
}

1. 优先考虑原子性操作（强依赖场景） #

如果业务规则要求用户必须绑定钱包才能正常使用，那么注册操作应该是原子性的：要么用户和钱包都创建成功，要么全部回滚。这种情况下：

• 钱包创建失败时，调用userService删除已创建的用户
• 返回500 Internal Server Error（如果是钱包服务临时故障、网络问题等不可控因素），或422 Unprocessable Entity（如果是业务规则不允许创建钱包，比如用户不符合钱包开通条件）

这种方案最符合REST语义，因为注册是一个完整的业务动作，客户端不需要处理“部分成功”的复杂逻辑。

2. 允许部分成功（弱依赖场景） #

如果业务允许用户存在但暂时没有钱包（比如后续可以手动触发钱包创建），则不推荐使用207状态码——因为207是WebDAV专用状态码，普通REST客户端可能无法正确解析其响应格式，兼容性差。推荐以下两种方案：

方案A：返回201 + 响应体明确标注状态

用户已经成功创建，所以返回201 Created是符合语义的，但需要在响应体中明确告知钱包创建失败的细节。可以定义一个响应DTO来承载这些信息：

// 自定义注册响应DTO
public class RegisterResponse {
    private User user;
    private boolean walletCreated;
    private String walletFailureReason;

    // 构造器、getter、setter省略
}

@PostMapping("/register")
public ResponseEntity<RegisterResponse> saveUser(@RequestBody User user) {
    user.setUserId(sequenceGeneratorService.generateSequence(User.SEQUENCE_NAME));
    user.getRoles().forEach(role -> role.setRoleId(sequenceGeneratorService.generateSequence(Role.SEQUENCE_NAME)));

    User savedUser = userService.saveUser(user);
    ResponseEntity<Wallet> createdWallet = createUserWallet(savedUser);
    
    RegisterResponse response = new RegisterResponse();
    response.setUser(savedUser);
    
    if (createdWallet.getStatusCode().is2xxSuccessful()) {
        savedUser.setWallet(createdWallet.getBody());
        response.setWalletCreated(true);
        return new ResponseEntity<>(response, HttpStatus.CREATED);
    } else {
        response.setWalletCreated(false);
        response.setWalletFailureReason(String.format("钱包创建失败，状态码：%s", createdWallet.getStatusCode()));
        // 用户已创建成功，返回201
        return new ResponseEntity<>(response, HttpStatus.CREATED);
    }
}

方案B：返回200 + 详细状态信息

如果觉得201只适合“完全成功”的场景，也可以返回200 OK，同样在响应体中明确区分用户和钱包的创建状态。但这种方案的语义稍弱，因为201更精准地表示“资源已被创建”。

为什么不推荐207？ #

HTTP标准中207 MULTI-STATUS是为WebDAV的多资源批量操作设计的，并非通用REST API的标准状态码。很多HTTP客户端框架、网关或监控工具可能不会处理207的特殊响应格式（比如要求XML或特定JSON结构），导致客户端无法正确解析结果，增加对接成本。

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