Floor 2
Posted at: 6/30/26 15:38
UCanAccess 是一个纯 Java 编写的 JDBC 驱动，能让 Java 程序直接读写 Microsoft Access 数据库（.mdb/.accdb 格式），不用装 Access 软件也不用配 ODBC 数据源 。
这玩意儿到底能干啥
跨平台运行：在 Windows、macOS、Linux 上都能用，Java 8 及以上版本都支持 。
免配置：不需要安装 Microsoft Access 组件，也不用配置 ODBC 数据源，把 JAR 包加到项目类路径就能用 。
标准 JDBC 接口：按标准 JDBC 方式写代码，方便切换不同数据库后端 。
怎么把它装到项目里
Maven 依赖：在 pom.xml 中添加 <dependency><groupId>io.github.spannm</groupId><artifactId>ucanaccess</artifactId><version>5.1.5</version></dependency>，Maven 会自动拉取所需的核心库 。
手动添加 JAR：需要把 ucanaccess 主驱动 JAR 和依赖库（jackcess、hsqldb、commons-lang3、commons-logging）都放到类路径中，只加主 JAR 会报 ClassNotFoundException 。
连接代码示例：String url = "jdbc:ucanaccess://" + 数据库文件路径; Connection conn = DriverManager.getConnection(url); 。
连接时有啥坑要注意
远程路径要用 UNC 格式：访问远程共享数据库时不能用本地文件路径语法，必须用双反斜杠开头的 UNC 路径如 \\服务器\共享\文件.mdb，混合用正斜杠和盘符冒号会报"illegal char <:>"错误 。
路径末尾要带文件名：UNC 路径必须指向具体数据库文件，不能只指向文件夹 。
权限要配好：UCanAccess 本身不处理身份认证，依赖系统级网络凭据，服务端防火墙需放行 SMB 端口且客户端要有访问共享的 Windows 凭据 。
依赖库要匹配版本：jackcess 和 hsqldb 的版本要和 ucanaccess 主驱动匹配，不同版本间可能不兼容 。
