解决DB2的“参数无效:未知列名”(ErrorCode: -4460)的问题

最近工作时遇到一个挺奇怪的问题,在Eclipse中启动工程时总是会报下面的错误,导致项目启动失败:

工程启动错误日志

看了一下错误日志,发现是执行下面的查询SQL时报错:

  1. SELECT
  2. FUNCTION_CODE AS "functionCode",
  3. URL_LOC AS "functionUrl"
  4. FROM
  5. LTVM_URL_FUNCTION

这个问题的错误码是-4460,错误消息提示工程执行完查询,然后映射结果集时,在表中找不到相应的列。奇怪的地方就在于:如果在数据库中执行这段查询SQL,功能完全正常,不会报错;如果在工程中执行这段查询SQL,则会报-4460错误;但如果将这段查询SQL中的AS子句全部删除,那么在工程中执行也不会报错。

经过一番搜索,终于在IBM的知识库中找到了答案,相关链接如下:

  1. Tech Tip: IBM Universal JDBC Driver behavior when calling ResultSetMetaData.getColumnName and getColumnLabel against a DB2 LUW server (Thoughts from Support)

  2. Examples of ResultSetMetaData.getColumnName and ResultSetMetaData.getColumnLabel values

  3. Examples of ResultSetMetaData.getColumnName and ResultSetMetaData.getColumnLabel values

根据IBM知识库的描述,这是因为IBM提供的db2jcc.jar数据库驱动程序使用了JDBC 4.0,导致结果集映射的规则不同于3.0版本,从而导致找不到列的错误。只需要在Tomcat配置文件中添加连接属性useJDBC4ColumnNameAndLabelSemantics=2,强制使用JDBC 3.0,即可解决这个问题,这个连接属性的取值范围和意义在上述知识库中都能找到。如下图所示:

JDBC连接属性