OceanBase Connector/J 里头那些 SQL 异常，树叶云带你慢慢捋一捋

开始）

说起用Java程序连接OceanBase数据库,那个官方的JDBC驱动，就是OceanBase Connector/J，咱们程序员肯定不陌生，干活的时候，哪能一帆风顺啊，最常打交道的“老朋友”就是各种SQL异常，这些异常提示有时候一眼就能看懂，有时候却像谜语一样，让人摸不着头脑，树叶云就和大家一起，把这些常见的异常情况慢慢捋一捋，看看它们到底想告诉我们什么。

最基础也是最常见的,就是连接不上数据库的异常，当你兴冲冲地启动程序，满心期待着数据流动起来，结果控制台啪叽一下给你甩出一个java.sql.SQLException: Cannot create PoolableConnectionFactory之类的错误，心情瞬间就凉了半截，这通常意味着你的程序根本就没能找到OceanBase数据库的大门，这时候别慌，咱们得像侦探一样排查，检查一下你的连接字符串，也就是JDBC URL，是不是写对了，IP地址或者域名对不对？端口号是不是监听端口（默认是2883）？里面的参数比如database（或者老版本的tenant）指定对了没有？可别小看这些细节，一个字母写错就全盘皆输，想想网络通不通？是不是有防火墙把路给拦住了？你可以试着用数据库客户端工具，比如OBClient或者DBeaver，用同样的信息连一下，如果他们也连不上，那问题八成出在网络或者数据库服务本身，可能数据库还没启动，或者你的账号没有远程连接的权限，根据OceanBase的官方文档，创建用户时需要注意授权的HOST范围，如果限制为localhost，那从其他机器自然就连不进来了。

好不容易连上了数据库,接下来执行SQL语句，又可能碰到各种执行时的异常，这类异常通常都带着OceanBase返回的错误码和描述信息，这是最直接的线索，你可能会遇到java.sql.SSQLException: Table 'test.tbl_example' doesn't exist，这很明显，就是表不存在，可能是表名写错了，大小写没注意（OceanBase默认是大小写敏感的），或者数据库名（schema名）搞混了，还有一种常见的是权限问题，比如java.sql.SQLException: SELECT command denied to user 'username'@'host' for table 'table_name'，这说明你当前用的这个数据库用户，没有被授予访问这张表的SELECT权限，这时候就需要联系数据库管理员（DBA），给你把相应的权限 grant 一下。

错误信息会稍微绕一点,你执行一个INSERT语句，可能会报错java.sql.SSQLException: Duplicate entry 'xxx' for key 'PRIMARY'，这是在说你要插入的数据，其主键的值‘xxx’在表里已经存在了，违反了主键的唯一性约束，这时候你得检查一下，是不是真的插入了重复的数据，或者你的业务逻辑里生成主键的方式有问题。

再复杂一点,涉及到事务和锁的异常，在高并发的场景下，你可能会碰到超时相关的异常，像java.sql.SQLTimeoutException，这可能是你的SQL语句本身执行得太慢了，超过了wait_timeout之类的参数设置；也可能是遇到了锁等待，你的事务在等待另一个事务释放锁，但等得太久了，OceanBase作为分布式数据库，锁的情况可能更复杂一些，如果事务中发生了死锁，OceanBase会主动选择一个事务进行回滚，然后你的程序就会收到一个死锁异常，比如java.sql.SSQLException: Deadlock found when trying to get lock，遇到这种情况，通常的做法是让应用程序稍后重试这个事务。

数据类型不匹配也是一个坑,你试图把一个字符串‘abc’插入到一个整型字段里，肯定会报错，类似java.sql.SSQLException: Incorrect integer value: 'abc' for column 'id' at row 1，这种错误比较直白，检查一下你的Java对象类型和数据库表字段类型的映射关系就行，在使用PreparedStatement的时候，用对的set方法（比如setInt, setString）能很大程度上避免这类问题。

还想提一下资源相关的问题,你可能会碰到java.sql.SQLNonTransientConnectionException: No operations allowed after connection closed，这表示你试图在一个已经关闭的数据库连接上执行操作，这通常是由于连接管理不当造成的，也许是你手动调用了connection.close()，然后又去用这个connection；更常见的是在使用连接池时，连接被连接池回收了，但你的代码还持有这个连接的引用，这时候就需要检查你的代码逻辑，确保在使用完ResultSet、Statement之后及时关闭它们，并且以正确的方式将Connection返还给连接池。

遇到OceanBase Connector/J抛出的SQL异常，别急着头疼，第一件事就是仔细阅读异常信息，OceanBase通常会把错误原因说得比较清楚，然后根据错误信息，像排查网络故障一样，一层一层地检查：连接参数、网络、权限、SQL语法、数据类型、事务状态等等，大部分问题都能通过清晰的日志和耐心的排查来解决，如果错误信息实在看不懂，或者涉及到底层分布式的问题，别忘了求助于OceanBase的官方文档和社区，那里有更详细的错误码解释和解决方案，慢慢来，多实践，这些异常就会从拦路虎变成帮你熟悉OceanBase的好帮手。 结束）