Java Spring Boot JPA投影(Projection)字段赋值报错如何解决

Spring Data JPA 接口式投影默认返回的是TupleBackedMap类型的动态代理对象，这个对象本质是对数据库查询返回的只读元组的包装，不支持任何修改操作。你在Projection接口中定义的setLabel()方法没有对应的可写字段支撑，直接调用就会抛出 "cannot set projection A TupleBackedMap cannot be modified." 错误。

根据业务场景选以下任意一种方案即可：

方案1：投影内通过SpEL直接计算字段（最推荐，无额外代码成本） #

如果label字段的生成逻辑只依赖投影本身的其他字段，不需要依赖Service层外部参数，直接在投影接口里用@Value注解写SpEL表达式计算，完全不需要在Service层赋值，也不用定义setter方法：

public interface DemoProjection {
    UUID getUuid();
    String getName();
    String getSurname();

    // target指代当前投影关联的原始实体，直接读取字段拼接即可
    @Value("#{ 'Name: ' + target.name + '\nSurname: ' + target.surname }")
    String getLabel();
}

这种方式在查询结果映射阶段就会自动计算好label值，Service层直接调用getLabel()就能拿到结果，从根源避免修改只读代理的问题。

方案2：包装可写的投影实现类（适合需要Service层动态计算label的场景） #

如果label的计算逻辑需要依赖Service层的外部变量（比如配置项、上下文信息），可以自己写一个投影接口的实现类，包装Repository返回的只读代理数据，再对可写字段赋值：

1. 编写投影实现类：

public class DemoProjectionImpl implements DemoProjection {
    private final UUID uuid;
    private final String name;
    private final String surname;
    private String label;

    // 构造方法接收只读代理的原始数据
    public DemoProjectionImpl(DemoProjection source) {
        this.uuid = source.getUuid();
        this.name = source.getName();
        this.surname = source.getSurname();
    }

    @Override
    public UUID getUuid() { return uuid; }
    @Override
    public String getName() { return name; }
    @Override
    public String getSurname() { return surname; }
    @Override
    public String getLabel() { return label; }
    @Override
    public void setLabel(String label) { this.label = label; }
}

2. 调整Service层逻辑：

public DemoProjection findAByUuid(UUID uuid) {
    final DemoProjection source = demoRepository.findAByUuid(uuid);
    final DemoProjection demo = new DemoProjectionImpl(source);
    final String label = String.format(
            "Name: %s%nSurname: %s",
            demo.getName(),
            demo.getSurname());
    demo.setLabel(label);
    return demo;
}

方案3：使用类-based投影替换接口投影 #

把接口投影换成普通Java POJO作为DTO，Spring Data JPA会通过构造方法实例化普通对象，不存在只读代理的限制，所有setter方法都可以正常调用：

1. 定义投影DTO：

public class DemoDto {
    private UUID uuid;
    private String name;
    private String surname;
    private String label;

    // 构造方法参数顺序、类型要和查询返回的字段一一对应
    public DemoDto(UUID uuid, String name, String surname) {
        this.uuid = uuid;
        this.name = name;
        this.surname = surname;
    }

    // 生成所有字段的getter、setter
    public UUID getUuid() { return uuid; }
    public void setUuid(UUID uuid) { this.uuid = uuid; }
    public String getName() { return name; }
    public void setName(String name) { this.name = name; }
    public String getSurname() { return surname; }
    public void setSurname(String surname) { this.surname = surname; }
    public String getLabel() { return label; }
    public void setLabel(String label) { this.label = label; }
}

2. 将Repository对应查询方法的返回值改为DemoDto，后续Service层直接调用setLabel()赋值即可，不会抛出只读错误。

• 不要尝试直接修改Repository返回的接口投影代理对象，它本质是数据库查询结果的只读包装，没有写入能力
• 固定规则的字段计算优先选SpEL内聚在投影内部的方案，代码最简洁，维护成本最低

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