在Mybatis开发中，我们通常会定义数据访问层的Mapper接口，然后通过SqlSession获取接口实例来调用方法。不少开发者在编写测试类时，会直接将测试方法定义为静态方法，然后尝试调用Mapper接口的非静态方法，此时就会触发无法从静态上下文中引用非静态方法的报错。
报错场景还原
假设我们有一个用户查询的Mapper接口，定义如下：
public interface UserMapper {
// 根据id查询用户
User selectById(Integer id);
}
如果我们编写如下的测试类，就会触发对应的报错：
import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import java.io.IOException;
import java.io.InputStream;
public class UserMapperTest {
// 静态测试方法，直接调用非静态的Mapper方法
public static void main(String[] args) throws IOException {
// 加载Mybatis配置文件
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
SqlSession sqlSession = sqlSessionFactory.openSession();
// 获取Mapper接口实例
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
// 错误调用：在静态方法中尝试调用非静态方法
User user = userMapper.selectById(1);
System.out.println(user);
sqlSession.close();
}
}
上述代码中，main方法是静态方法，而userMapper是实例对象，selectById是非静态方法，在静态方法中直接调用实例的非静态方法就会触发该报错。
报错原因解析
要理解这个报错，首先需要明确Java中静态上下文和非静态方法的调用规则：
- 静态方法属于类本身，在类加载时就会初始化，不需要创建类的实例就可以调用，比如我们直接通过
类名.静态方法名()的方式调用。 - 非静态方法属于类的实例，必须先创建类的实例对象，才能通过实例对象调用，不能直接通过类名调用。
- 静态上下文中（比如静态方法、静态代码块）不能直接引用非静态的成员变量或者非静态方法，因为此时还没有对应的实例对象，无法完成方法调用。
在Mybatis的使用场景中，Mapper接口的方法都是非静态的，我们通过sqlSession.getMapper(UserMapper.class)获取的是接口的代理实例，调用方法必须通过这个实例对象，而不能直接通过接口类名调用。如果在静态方法中直接使用这个实例调用方法，就违反了上述调用规则，因此会抛出报错。
解决方案
方案一：将测试逻辑移到非静态方法中
我们可以把测试逻辑放到非静态的实例方法中，然后在main方法中创建测试类的实例，再调用实例方法：
import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import java.io.IOException;
import java.io.InputStream;
public class UserMapperTest {
// 非静态的测试方法
public void testSelectById() throws IOException {
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
SqlSession sqlSession = sqlSessionFactory.openSession();
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
// 正常调用非静态方法
User user = userMapper.selectById(1);
System.out.println(user);
sqlSession.close();
}
public static void main(String[] args) throws IOException {
// 创建测试类实例，调用非静态方法
UserMapperTest test = new UserMapperTest();
test.testSelectById();
}
}
方案二：使用JUnit等测试框架
实际开发中我们更推荐使用JUnit等测试框架编写测试类，测试框架的测试方法默认是非静态的，不需要我们手动处理静态上下文的问题：
import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import org.junit.Test;
import java.io.IOException;
import java.io.InputStream;
public class UserMapperTest {
@Test
public void testSelectById() throws IOException {
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
SqlSession sqlSession = sqlSessionFactory.openSession();
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
User user = userMapper.selectById(1);
System.out.println(user);
sqlSession.close();
}
}
注意事项
- Mybatis的Mapper接口不需要我们手动编写实现类，Mybatis会通过动态代理生成实现对象，但是调用方法时必须使用代理实例，不能直接通过接口名调用。
- 编写测试类时尽量避免把所有逻辑都写在
main静态方法中，使用专业的测试框架可以减少很多不必要的语法问题。 - 如果遇到同类报错，首先检查调用非静态方法的位置是否在静态上下文中，再确认是否通过实例对象调用方法。