
MyBatis 使用 获取 Oracle 自定义主键时,若 resultType 错误配置为 java.lang.String 会导致“unsupported return type”异常;正确做法是使用别名 string 并配合 SQL 显式类型转换。
mybatis 使用 `
在 MyBatis 中, 的 resultType 属性不接受完整的 Java 类名(如 java.lang.String),而应使用 MyBatis 内置的类型别名。对于字符串类型,必须使用小写的 string(注意:不是 String,也不是 java.lang.String),这是 MyBatis 官方支持的标准别名之一。
✅ 正确写法如下:
<insert id="makeNewOrder" parametertype="Order"><selectkey resulttype="string" keyproperty="orderCode" order="BEFORE">
SELECT CAST(TO_CHAR(SYSDATE, 'yyyymmdd') || order_seq.NEXTVAL || #{storeCode} AS VARCHAR2(50)) FROM DUAL
</selectkey>
INSERT INTO orders (orderCode, storeCode,
<if test="memberId != null">memberId,</if>
orderState)
VALUES (#{orderCode}, #{storeCode},
<if test="memberId != null">#{memberId},</if>
'apply')
</insert>
? 关键修复点说明:
-
resultType="string":使用 MyBatis 内置别名string(全小写),而非java.lang.String或String; -
CAST(... AS VARCHAR2(50)):显式将拼接结果转为 Oracle 可识别的字符类型,避免驱动因返回CHAR/VARCHAR不明确而解析失败; -
ORDER="BEFORE"表示在INSERT执行前生成主键值,并自动赋给Order对象的orderCode属性(要求Order类中存在对应 setter 方法)。
⚠️ 注意事项:
- 确保
Order实体类中orderCode字段为String类型,且有公共setOrderCode(String)方法; - 若使用 MyBatis 3.4+,推荐优先考虑
的替代方案——如 Oracle 12c+ 支持IDENTITY列或RETURNING INTO语法(需配合useGeneratedKeys="true"和keyProperty),但本例中因需自定义格式(日期+序列+门店码),selectKey仍是合理选择; - 测试时建议开启 MyBatis 日志(
log4j.logger.org.apache.ibatis=DEBUG),确认生成的 SQL 与参数绑定是否符合预期。
通过以上调整,即可彻底解决 "has an unsupported return type: class java.lang.String" 异常,安全、可靠地在插入前生成并注入业务主键。










