解决Thymeleaf表单插入Wallet时user_id为空的关联数据问题

核心问题分析 #

Wallet实体的user字段被标记为必填（nullable=false），但当前Thymeleaf表单及后端保存接口未传递或关联目标User的ID，导致插入数据库时触发Column 'user_id' cannot be null约束错误。

改造步骤 #

1. 修改表单展示接口，传入目标用户ID #

根据业务场景选择两种实现方式：

场景一：给当前登录用户创建钱包

@GetMapping("/showNewWalletForm")
public String showNewWalletForm(Model model, Authentication authentication) {
    // 获取当前登录用户（需确保UserRepository有findByUsername方法）
    User currentUser = userRepository.findByUsername(authentication.getName())
            .orElseThrow(() -> new IllegalArgumentException("当前用户不存在"));
    
    Wallet wallet = new Wallet();
    model.addAttribute("wallet", wallet);
    // 将当前用户ID传入前端
    model.addAttribute("userId", currentUser.getId());
    return "new_wallet";
}

场景二：指定用户创建钱包（如管理员操作）

@GetMapping("/user/{userId}/showNewWalletForm")
public String showNewWalletForm(@PathVariable Long userId, Model model) {
    User targetUser = userRepository.findById(userId)
            .orElseThrow(() -> new IllegalArgumentException("用户不存在，ID：" + userId));
    
    Wallet wallet = new Wallet();
    model.addAttribute("wallet", wallet);
    model.addAttribute("userId", userId);
    return "new_wallet";
}

2. 修改Thymeleaf表单，添加隐藏字段传递用户ID #

在表单中增加隐藏字段，将用户ID传递到后端：

<form action="#" th:action="@{/api/wallet/saveWallet}" th:object="${wallet}" method="POST">
    <!-- 隐藏字段传递用户ID，避免前端手动修改 -->
    <input type="hidden" th:value="${userId}" name="userId">

    <input type="text" th:field="*{walletName}" placeholder="钱包名称" class="form-control mb-4 col-4">

    <input type="text" th:field="*{initialBalance}" placeholder="初始余额" class="form-control mb-4 col-4">

    <button type="submit" class="btn btn-info col-2"> 保存钱包</button>
</form>

3. 修改保存Wallet的后端接口，关联User对象 #

复用REST接口的校验逻辑，查询User并关联到Wallet后保存：

@PostMapping("/saveWallet")
public String saveWallet(@ModelAttribute("wallet") Wallet wallet, @RequestParam Long userId) {
    // 校验同名钱包是否存在
    if (walletRepository.existsByUserIdAndWalletName(userId, wallet.getWalletName())) {
        // 可添加错误提示返回表单页面，此处简化为带参数重定向
        return "redirect:/showNewWalletForm?error=duplicate";
    }

    // 查询目标User并关联到Wallet
    User user = userRepository.findById(userId)
            .orElseThrow(() -> new IllegalArgumentException("用户不存在，ID：" + userId));
    wallet.setUser(user);
    
    walletService.saveWallet(wallet);
    return "redirect:/";
}

4. 补充Wallet实体的访问方法 #

确保Wallet实体有user字段的getter/setter，否则ORM框架无法持久化关联关系：

// 在Wallet实体类中添加
public User getUser() {
    return user;
}

public void setUser(User user) {
    this.user = user;
}

关键逻辑说明 #

• 对齐REST接口的校验规则：先验证用户存在性、钱包名称唯一性，再关联User保存
• 通过隐藏字段传递userId，既保证关联关系，又避免前端非法修改
• 确保实体类关联字段的访问权限，保证ORM框架正常处理关联映射

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