嘿，咱们一步步排查下Grails访问现有MySQL数据表返回null的常见问题——这种情况在对接遗留数据库时特别常见，咱们逐个拆解：

1. 先确认数据库连接配置是否正确 #

首先得确保application.yml（或者application.groovy）里的数据库连接参数没毛病，这是最基础的：

dataSource:
    pooled: true
    jmxExport: true
    driverClassName: com.mysql.cj.jdbc.Driver # MySQL8+必须用这个驱动，5.x版本用com.mysql.jdbc.Driver
    username: 你的数据库用户名
    password: 你的数据库密码
    dialect: org.hibernate.dialect.MySQL8Dialect # 对应你的MySQL版本，5.x用MySQL5Dialect
    url: jdbc:mysql://localhost:3306/你的数据库名?useUnicode=yes&characterEncoding=UTF-8&serverTimezone=UTC

重点注意：驱动版本要和MySQL版本匹配，MySQL8+必须加时区参数serverTimezone=UTC，不然容易出现连接失败或查询异常。

2. 域类与现有数据表的映射是核心 #

对接已有数据表时，必须确保域类和数据库表的映射完全对应，这是最容易踩坑的地方：

• 表名映射：如果数据库表名和域类名不符合Grails默认的「驼峰转下划线」规则，一定要用static mapping指定表名
• 列名映射：列名不匹配的话也要单独指定对应关系
• 主键配置：如果数据库主键不是自增类型，必须设置generator: 'assigned'，不然Hibernate会自动生成主键值，自然找不到现有数据

举个实际例子，假设数据库表是old_users，主键是user_id，列名是user_name和email_addr：

class User {
    Long userId
    String username
    String email

    static mapping = {
        table 'old_users' // 明确指定对应的数据表
        id column: 'user_id', generator: 'assigned' // 主键非自增时必须添加此配置
        userId column: 'user_id'
        username column: 'user_name'
        email column: 'email_addr'
    }
}

3. 检查控制器里的查询代码写法 #

控制器里的查询逻辑也可能导致返回null，比如：

class UserController {
    def index() {
        // 别随便用get(1)，除非数据库里真的有主键为1的记录！
        // def user = User.get(1)
        
        // 可以先尝试查询所有数据，排除查询条件的问题
        def allUsers = User.list()
        // 或者用明确的条件查询
        def targetUser = User.findByUsername("test_user_01")
        
        render view: 'index', model: [users: allUsers, user: targetUser]
    }
}

如果用get()方法，一定要传入数据库中存在的主键值；先查所有数据能快速判断是映射问题还是查询条件的问题。

4. 开启SQL日志看实际执行的语句 #

可以开启Hibernate的SQL日志，直接查看实际执行的SQL语句，快速定位问题：
在logback.groovy里添加这两行：

logger('org.hibernate.SQL', DEBUG, ['STDOUT'], false)
logger('org.hibernate.type.descriptor.sql.BasicBinder', TRACE, ['STDOUT'], false)

启动应用后，控制台会打印出Hibernate执行的SQL语句，你直接把这些SQL拿到MySQL客户端执行，就能判断：如果SQL执行有结果但Grails返回null，那就是映射的问题；如果SQL本身没结果，那就是查询条件或数据的问题。

5. 修正build.gradle里的依赖版本 #

你提供的build.gradle里，Hibernate5插件的版本写法${gormVersion-".RELEASE"}容易导致版本不匹配，建议直接指定明确的版本，比如如果你的Grails版本是3.3.x，对应的GORM版本是6.1.x，Hibernate5插件可以这么写：

classpath "org.grails.plugins:hibernate5:6.1.12"

版本不匹配会导致ORM映射出现各种奇怪问题，包括查询返回null。

6. 最后确认数据库用户权限 #

别忽略最基础的点：你的数据库用户必须拥有SELECT权限！如果没有权限，查询要么返回null，要么直接抛出权限异常。

按照这些步骤排查下来，基本能找到问题所在——最常见的就是域类映射错误，或者主键生成策略不对，导致Hibernate找不到对应的数据。

内容的提问来源于stack exchange，提问作者Dor-Ron