Spring Security示例中@Query注解表达式及'm'符号解析求助

问题场景代码 #

SecurityMessageRepository类：

/**
 * A repository that integrates with Spring Security for accessing {@link Message}s.
 */
@Repository
public interface SecurityMessageRepository extends MessageRepository {
    @Query("SELECT m FROM Message WHERE m.to_id = ?#{principal?.id }")
    List<Message> findAll();
}

初始化数据data.sql：

insert into user(id,email,password,firstName,lastName) values (0,'rob@example.com','password','Rob','Winch');
insert into user(id,email,password,firstName,lastName) values (1,'luke@example.com','password','Luke','Taylor');

insert into message(id,created,to_id,summary,text) values (100,'2023-01-05 10:00:00',0,'Hello Rob','This message is for Rob');
insert into message(id,created,to_id,summary,text) values (101,'2023-01-05 11:00:00',0,'How are you Rob?','This message is for Rob');
insert into message(id,created,to_id,summary,text) values (102,'2023-01-05 12:00:00',0,'Is this secure?','This message is for Rob');

insert into message(id,created,to_id,summary,text) values (110,'2023-01-05 10:00:00',1,'Hello Luke','This message is for Luke');
insert into message(id,created,to_id,summary,text) values (111,'2023-01-05 10:00:00',1,'Greetings Luke','This message is for Luke');
insert into message(id,created,to_id,summary,text) values (112,'2023-01-05 10:00:00',1,'Is this secure?','This message is for Luke');

1. 符号'm'的含义 #

这是JPQL（Java持久化查询语言） 中的实体别名，SELECT m FROM Message里的m是Message实体的简写指代。后续用m.to_id可直接引用Message实体对应数据库表的to_id字段，目的是简化查询语句，避免重复书写实体全称，在多表关联查询时优势更明显。

2. m.to_id = ?#{principal?.id }的作用 #

这是Spring Data JPA结合Spring Security的SpEL（Spring表达式语言） 动态参数注入逻辑：

• principal是Spring Security上下文里当前登录用户的认证对象，代表当前已登录的用户
• ?.是空安全运算符，避免未登录时principal为null导致的空指针异常
• 整个表达式的核心作用是：动态获取当前登录用户的id，作为查询条件，只返回to_id等于当前用户id的消息记录——实现数据权限隔离，每个用户只能看到发给自己的消息。
  比如data.sql里，Rob（id=0）登录后会收到3条to_id=0的消息，Luke（id=1）登录后则收到3条to_id=1的消息。

3. IDE提示“Cannot resolve symbol 'm'”的解决 #

这是IDE静态检查的问题，代码本身逻辑没问题，解决方式如下：

• 确认Message实体类上标注了@Entity注解，且to_id字段有对应的映射注解（比如@Column(name = "to_id")）
• 刷新IDE的JPA实体索引：以IntelliJ为例，通过File → Invalidate Caches... → Invalidate and Restart操作
• 确保项目的Spring Data JPA依赖配置正确，IDE已启用JPA相关支持插件

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