org.springframework.dao.InvalidDataAccessApiUsageException: ERR value is not an integer or out of ra

本文解析了使用Spring Redis的increment方法时出现的错误,并通过实验对比不同序列化器的效果,得出只有特定序列化器可以正常工作的结论。

背景

使用spring redis的increment方法时,爆出如上错误,详细异常栈如下

org.springframework.dao.InvalidDataAccessApiUsageException: ERR value is not an integer or out of range; nested exception is redis.clients.jedis.exceptions.JedisDataException: ERR value is not an integer or out of range
at org.springframework.data.redis.connection.jedis.JedisExceptionConverter.convert(JedisExceptionConverter.java:64)
at org.springframework.data.redis.connection.jedis.JedisExceptionConverter.convert(JedisExceptionConverter.java:41)
at org.springframework.data.redis.PassThroughExceptionTranslationStrategy.translate(PassThroughExceptionTranslationStrategy.java:37)
at org.springframework.data.redis.FallbackExceptionTranslationStrategy.translate(FallbackExceptionTranslationStrategy.java:37)
at org.springframework.data.redis.connection.jedis.JedisConnection.convertJedisAccessException(JedisConnection.java:212)
at org.springframework.data.redis.connection.jedis.JedisConnection.incrBy(JedisConnection.java:1439)
at org.springframework.data.redis.core.DefaultValueOperations$3.doInRedis(DefaultValueOperations.java:66)
at org.springframework.data.redis.core.DefaultValueOperations$3.doInRedis(DefaultValueOperations.java:63)
at org.springframework.data.redis.core.RedisTemplate.execute(RedisTemplate.java:202)
at org.springframework.data.redis.core.RedisTemplate.execute(RedisTemplate.java:164)
at org.springframework.data.redis.core.AbstractOperations.execute(AbstractOperations.java:88)
at org.springframework.data.redis.core.DefaultValueOperations.increment(DefaultValueOperations.java:63)

分析

redis对任何不合法的值,都称为ERR
这里写图片描述
也就是说,上述异常的意思是,增加的值(ERR)不是integer或者超出了integer范围,所以才报的错误。
根据同事的建议,只有使用StringRedisSerializer序列化器才能使用incrment方法!那么为什么呢,为什么使用了StringRedisSerializer就可以而使用默认序列化器就不行呢?

实验

我们都知道序列化器是,将key或者value序列化成流,存储到redis。首先看一下RedisSerializer接口
这里写图片描述

它有两个方法,存储到redis时,使用的是serialize(T t)方法
为了测试各个序列化器的区别,我做了个测试

@Test
    public void testSerializer(){

        RedisTemplate<String, String> template = new RedisTemplate<String, String>();
        template.setConnectionFactory(connectFactory);
        template.afterPropertiesSet();

        ValueOperations<String, String>  operations = template.opsForValue();
        template.setKeySerializer(new StringRedisSerializer());
        template.setValueSerializer(new StringRedisSerializer());
        operations.set("StringRedisSerializer", "1");

        template.setKeySerializer(new GenericToStringSerializer<String>(String.class));
        template.setValueSerializer(new GenericToStringSerializer<String>(String.class));
        operations.set("GenericToStringSerializer", "1");


        template.setKeySerializer(new GenericJackson2JsonRedisSerializer());
        template.setValueSerializer(new GenericJackson2JsonRedisSerializer());
        operations.set("GenericJackson2JsonRedisSerializer", "1");

        template.setKeySerializer(new Jackson2JsonRedisSerializer<String>(String.class));
        template.setValueSerializer(new Jackson2JsonRedisSerializer<String>(String.class));
        operations.set("Jackson2JsonRedisSerializer", "1");

        template.setKeySerializer(new JdkSerializationRedisSerializer());
        template.setValueSerializer(new JdkSerializationRedisSerializer());
        operations.set("JdkSerializationRedisSerializer", "1");


    }

结果
这里写图片描述
这里写图片描述
这里写图片描述
这里写图片描述
这里写图片描述

领悟

至此真相大白,

  • GenericJackson2JsonRedisSerializer、Jackson2JsonRedisSerializer是先将对象转为json,然后再保存到redis,所以,1在redis中是字符串1,所以无法进行加1
  • JdkSerializationRedisSerializer使用的jdk对象序列化,序列化后的值有类信息、版本号等,所以是一个包含很多字母的字符串,所以根本无法加1,这个序列化器跟memcache的序列化规则很像memcache怎样存储的对象
  • GenericToStringSerializer、StringRedisSerializer将字符串的值直接转为字节数组,所以保存到redis中是数字,所以可以进行加1

最后,看一下StringRedisSerializer的源代码
这里写图片描述

GenericToStringSerializer serialize方法

public byte[] serialize(T object) {
        if (object == null) {
            return null;
        }
        String string = converter.convert(object, String.class);
        return string.getBytes(charset);
    }

结论

使用GenericToStringSerializer、StringRedisSerializer序列化器,都可以使用increment方法

<think>好的,我现在要解决用户关于org.springframework.dao.InvalidDataAccessApiUsageException: Nested entities are not supported的问题。首先,我需要理解这个异常的具体含义和常见原因。根据经验,这通常与Spring Data JPA中的实体嵌套有关。可能用户在使用JPA时,尝试将实体类作为另一个实体的属性,但配置不正确,导致框架不支持这样的嵌套结构。 接下来,我需要考虑用户可能的场景。比如,用户可能在定义JPA实体时,将一个实体类作为另一个实体类的字段,但没有正确使用关联注解如@OneToOne、@ManyToOne等,而是直接当作普通属性使用,导致Spring Data无法处理这种嵌套。另一种可能是用户误将非实体类作为嵌套对象使用,而该对象没有被正确标注为@Embeddable或使用@Embedded注解。 然后,我需要分析可能的原因。首先,检查实体类之间的关联是否正确配置。例如,如果两个实体之间存在关联关系,必须使用适当的JPA注解来定义它们之间的关系,如@ManyToOne或@OneToMany,并且确保级联操作和关联的维护方正确设置。其次,检查是否尝试嵌套非实体类,这时候可能需要使用@Embeddable和@Embedded来处理值对象,而不是实体关联。此外,还有可能是缓存或配置问题,比如Hibernate的二级缓存配置不当,导致无法处理嵌套实体。 接下来,我需要提供解决步骤。首先,确认嵌套的实体是否正确使用关联注解。例如,如果用户有一个Order实体包含User实体,应该在Order中使用@ManyToOne注解来正确建立关联。其次,如果嵌套的是值对象而非实体,应将其标注为@Embeddable,并在主实体中使用@Embedded。然后,检查实体类的所有注解是否正确,特别是主键@Id的存在。此外,查看Hibernate的日志,确认是否有更详细的错误信息,帮助定位问题。最后,确保所有依赖的库版本兼容,避免因版本不一致导致的问题。 同时,我需要给出示例代码,展示正确的实体关联和嵌入值对象的方式。例如,在订单实体中使用@ManyToOne关联用户,或者使用@Embedded和@Embeddable来处理地址这样的值对象。此外,提醒用户注意事务管理和级联操作,避免因事务未正确配置导致的异常。 最后,总结可能的原因和解决方案,帮助用户系统地排查问题。确保用户能够根据指导逐步检查代码,找到问题根源并进行修复。同时,建议用户查阅官方文档和相关资源,加深对JPA实体管理的理解,避免未来出现类似问题。</think>`org.springframework.dao.InvalidDataAccessApiUsageException: Nested entities are not supported` 是 Spring Framework 在处理数据访问时抛出的异常,通常与 **JPA/Hibernate 的实体映射配置**或 **Spring Data 的操作方式**有关。以下是该异常的详细解释及解决方法: --- ### **异常含义** 此异常表示框架检测到**不支持嵌套实体操作**的场景,常见于以下情况: 1. 实体类未正确配置关联关系(如 `@OneToMany`, `@ManyToOne` 等)。 2. 尝试将非托管对象(非实体类)嵌套到实体中,但未正确使用 `@Embeddable` 或 `@Embedded`。 3. 在查询或保存实体时,传递了不符合 JPA 规范的数据结构。 --- ### **常见场景与解决方案** #### **1. 实体关联映射错误** **问题复现**: 两个实体类之间需要建立关联(如 `User` 和 `Order`),但未正确使用 JPA 注解。 **错误示例**: ```java @Entity public class User { @Id private Long id; // 错误:直接嵌套 Order 实体,未配置关联关系 private List<Order> orders; } @Entity public class Order { @Id private Long id; } ``` **修复方案**: 使用 `@OneToMany` 或 `@ManyToOne` 明确关联关系,并指定关联的维护方: ```java @Entity public class User { @Id private Long id; @OneToMany(mappedBy = "user", cascade = CascadeType.ALL) private List<Order> orders = new ArrayList<>(); } @Entity public class Order { @Id private Long id; @ManyToOne @JoinColumn(name = "user_id") private User user; } ``` --- #### **2. 嵌套值对象未使用 `@Embeddable`** **问题复现**: 需要将一个类作为值对象嵌入实体中,但未标注 `@Embeddable` 和 `@Embedded`。 **错误示例**: ```java @Entity public class User { @Id private Long id; private Address address; // 错误:Address 未声明为 @Embeddable } // 缺少 @Embeddable 注解 public class Address { private String city; private String street; } ``` **修复方案**: 使用 `@Embeddable` 定义值对象,并在实体中使用 `@Embedded`: ```java @Entity public class User { @Id private Long id; @Embedded private Address address; } @Embeddable public class Address { private String city; private String street; } ``` --- #### **3. 尝试持久化游离对象** **问题复现**: 在未正确管理实体生命周期的情况下,尝试保存一个游离(detached)的嵌套实体。 **错误示例**: ```java User user = new User(); Order order = new Order(); // 未关联到 user user.getOrders().add(order); userRepository.save(user); // 抛出异常:order 未被正确关联 ``` **修复方案**: 确保双向关联关系的一致性: ```java User user = new User(); Order order = new Order(); order.setUser(user); // 关键:建立双向关联 user.getOrders().add(order); userRepository.save(user); ``` --- #### **4. 使用错误的查询方式** **问题复现**: 在自定义查询(如 JPQL 或 Criteria API)中,错误引用了嵌套实体的字段。 **错误示例**: ```java @Query("SELECT u FROM User u WHERE u.address.city = :city") // 错误:若 Address 是实体,需通过关联查询 List<User> findByCity(@Param("city") String city); ``` **修复方案**: 若 `Address` 是实体,需明确关联路径: ```java @Query("SELECT u FROM User u JOIN u.address a WHERE a.city = :city") List<User> findByCity(@Param("city") String city); ``` --- ### **排查步骤** 1. **检查实体映射**:确保所有嵌套对象正确使用 `@Embeddable` 或关联注解。 2. **验证级联操作**:如果涉及级联保存,检查 `cascade` 属性(如 `cascade = CascadeType.PERSIST`)。 3. **查看日志**:启用 Hibernate SQL 日志 (`spring.jpa.show-sql=true`) 确认实际执行的 SQL。 4. **简化测试**:编写单元测试逐步验证数据操作,定位具体触发异常的代码行。 --- ### **总结** 此异常的核心是 **JPA 实体映射配置不符合规范**。通过正确使用关联注解(`@OneToMany`、`@ManyToOne`)、值对象注解(`@Embeddable`/`@Embedded`)以及确保实体生命周期管理的一致性,可以解决绝大多数问题。如果仍无法解决,建议结合 Hibernate 的详细日志进一步分析。
评论 5
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值