MyBatis向双外键复合主键的关联表插入数据时提示userId为空报错

核心成因 #

常见触发该错误的原因主要有4类：

• 参数未绑定别名：当Mapper接口方法直接传入多个散列参数时，没有给参数添加@Param注解指定别名，MyBatis无法将#{userId}和传入的参数匹配，默认解析为null。
• 实体类属性名不匹配：若通过实体类封装参数传入，实体类没有对应名为userId的属性，或缺少对应getter方法，MyBatis读取属性失败返回null。
• 参数实际为空：业务层未做非空校验，前端或上游调用时实际未传递userId参数，开发者误判为参数已传递。
• 动态SQL判断错误：插入语句如果包含<if test>等动态逻辑，判断条件书写错误导致userId对应的占位符未被正确渲染，或参数值被过滤。

对应解决方案 #

• 给Mapper参数添加别名：如果是多参数直接传入，给每个参数添加@Param注解指定和SQL占位符对应的名称，示例：

// Mapper 接口方法写法
import org.apache.ibatis.annotations.Param;
import java.util.Date;

int addSubscription(@Param("userId") Long userId,
                    @Param("bundleId") Long bundleId,
                    @Param("promotionStartDate") Date promotionStartDate);

• 校验实体类属性：如果使用实体类作为入参，确保实体类存在userId属性和对应的getUserId()方法，属性名和SQL占位符严格对应。
• 添加入参非空校验：在Controller或Service层添加参数非空校验逻辑，避免空参数传入Mapper，可借助@NotNull注解或手动判空抛出业务异常。
• 核对动态SQL逻辑：如果使用了动态SQL拼接，检查<if>等标签的判断条件是否正确，避免把userId的判断条件写反、写错参数名。
• 开启SQL日志排查：在MyBatis配置中开启执行日志，查看实际传入预编译SQL的参数值，确认userId是否真的被正确传递，SpringBoot配置示例：

mybatis:
  configuration:
    # 控制台打印SQL和参数
    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl

你提供的原始插入SQL本身语法没有问题，不需要修改：

INSERT INTO Subscription (USERID,BUNDLEID,BUNDLESTARTDATE)
       VALUES (#{userId},#{bundleId},#{promotionStartDate});

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