1. 问题现象
Database 面板里已经成功连接了数据库,表都能看得到。
SQL 代码(MyBatis XML 或 @Select 注解)本身没有语法错误,在数据库里执行也能跑通。
但是IDEA 编辑器里,提示 Unable to resolve table 'xxx'。

2. 快速解决方案
这个问题的根源在于 IDEA 不知道当前的代码文件应该对应哪个数据库连接 。我们需要手动设置 SQL Resolution Scope(SQL 解析作用域)。

3. 为什么会有这个问题?
我明明设置了 SQL Dialect(方言),也连接了数据库,而且我只有一个数据库,IDEA 为什么不能自己匹配呢?
3.1 三大概念的区别
- SQL Dialect (方言) :相当于"语法书"。它告诉 IDEA 这段代码是 MySQL 语法还是 Oracle 语法,负责检查语法结构(如
SELECT拼写对不对)。 - Data Source (数据源):相当于"字典"。这是真实的数据库连接,包含所有的表结构元数据。
- Resolution Scope (作用域):相当于"指针/上下文"。它的作用是把"代码"和"字典"连起来。
飘红的原因就是: 你有了语法书,也有了字典,但 IDEA 不知道这段代码该查哪本字典。
3.2 为什么不能选 "All Data Sources"?
即使只有一个数据库,选"所有数据源"依然会报错。
本质原因:缺失"默认上下文" (Default Context)。
我们在写 SQL 时通常只写短表名 (如 SELECT * FROM user),而不是全限定名 (如 SELECT * FROM my_db.public.user)。
- 当你选"具体数据库"时: 相当于进入了该数据库的 Session,拥有了默认的 Schema。IDEA 遇到
user表,会自动去默认 Schema 下查找。(相当于相对路径:./user) - 当你选"所有数据源"时: 相当于站在了服务器的"大厅"里。虽然只有一个库,但因为没有执行
USE database这种切换上下文的操作,IDEA 面对user这个短名,不敢擅自猜测它是属于哪个库的。为了严谨和防止歧义,它选择报错。(相当于绝对路径缺失)