FineReport 连 Kingbase，连接最省事的数据办法是走 JDBC。但很多人卡在第一步——驱动包放错位置。连接FineReport 的数据设计器里，数据连接配置界面看着挺友好，连接可它不会告诉你驱动该扔哪儿。数据我见过不止一个同事把 kingbase8.jar 丢到 Tomcat 的连接 lib 下，重启报表服务器后照样报 ClassNotFoundException。数据正确路径是连接 FineReport 安装目录下的 webapps/webroot/WEB-INF/lib，设计器本地预览时则要放到设计器安装目录的数据 lib 文件夹。两个位置，连接少一个都不行。数据

驱动版本也得对。连接人大金仓 V8 和 V9 的数据 JDBC 驱动包名不一样。V8 是连接 kingbase8.jar，驱动类写 com.kingbase8.Driver；V9 换成了 kingbasejdbc.jar，类名变成 com.kingbase.Driver。写错一个字母，连接测试直接红叉。有次我帮人排查，他坚称驱动没问题，结果一看，V9 的库配了 V8 的类名，这种低级错误在深夜加班时特别容易犯。

URL 格式倒不复杂，跟 PostgreSQL 很像。jdbc:kingbase8://192.168.1.100:54321/testdb 这种写法最常用。端口默认 54321，不是 5432，这点和 PG 不一样，第一次配的人经常顺手写成 5432。如果 Kingbase 开了 SSL，还得在 URL 后面加 ?ssl=true&sslmode=require，否则连接会被拒绝，但报错信息很含糊，只说“连接失败”，不提示 SSL 问题。

FineReport 的数据连接配置界面里，有个“高级设置”容易被忽略。里面可以配连接池参数，比如初始连接数、最大活跃连接数。Kingbase 对空闲连接的超时控制比 MySQL 严格，默认 idle_in_transaction_session_timeout 是 0，但有些部署版本会改成 10 分钟。如果 FineReport 连接池里的空闲连接被 Kingbase 单方面掐断，报表刷新时就会蹦出“connection reset”之类的错。稳妥做法是把连接池的 testOnBorrow 打开，或者把 validationQuery 设成 select 1。这个细节在官方文档里藏得很深，我是抓包看出来的。

数据集写 SQL 时注意 Kingbase 的兼容模式。它默认跑在 Oracle 兼容模式下，dual 表能用，rownum 也能用。但如果你写 limit 分页，得确认数据库初始化时选了 PG 模式。有次我写了个 select * from table limit 10，报语法错误，换成 rownum <= 10 就过了。后来查参数发现，那个实例的 database_mode 是 oracle。FineReport 本身不关心这些，它只负责把 SQL 扔过去，报错就报错。

参数传递倒是顺畅。FineReport 的模板参数映射到 Kingbase 的 PreparedStatement 占位符，基本没坑。但注意日期类型，Kingbase 的 timestamp 和 FineReport 的日期控件传值时，如果格式不统一，会报“invalid input syntax for type timestamp”。我一般直接在数据集里用 to_date('${ startDate}', 'yyyy-mm-dd') 显式转换，省得两边打架。

最后说个实际跑通后的观察。Kingbase 的查询优化器对复杂子查询的处理比 MySQL 保守，同样的报表 SQL，在 MySQL 上跑 2 秒，Kingbase 可能要 8 秒。这时候别急着怪 FineReport，去 Kingbase 里 explain analyze 一下，多半是缺索引或者统计信息过期。手动 analyze 一下表，速度就回来了。数据库这层的事，报表工具背不了锅。