JSP连接ACCESS数据库全攻略：从JDBC-ODBC桥到UCanAccess迁移-北京尧图网络

简介面向刚接触Java Web和数据库编程的初学者作为JSP连接Access数据库的入门参考资料适合小型项目实践、课程设计或演示JDBC基本操作流程。文档先演示如何创建ACCESS数据库test.mdb在username表中建立uid、pwd两个文本字段并提示字段类型和表名可根据实际项目调整接着说明需要把test.mdb放到Tomcat安装路径下的webapps/ROOT/data目录否则JSP页面通过相对路径读取时会因找不到文件而报错。核心部分给出完整JSP示例代码逐步解释加载sun.jdbc.odbc.JdbcOdbcDriver驱动、拼接Microsoft Access Driver连接字符串、用DriverManager.getConnection建立Connection、创建Statement执行select查询、通过ResultSet.next遍历并输出用户名和密码最后依次关闭ResultSet、Statement、Connection避免资源泄漏同时包含异常捕获便于定位路径或驱动配置错误。资源包共1个doc文件压缩后约31KB内容集中、结构清晰打开即可对照练习。已有240人学习适合需要快速跑通JSP与Access读取流程并排查路径配置问题的开发者。1. JSP 连接 ACCESS 数据库绕不开的 JDBC-ODBC 桥JSP 连接 ACCESS 数据库很多新入门的人第一次接触 Web 数据库开发都会撞上这条路。它的典型场景是不想装 MySQL、Oracle电脑里恰好有 Office 自带的 ACCESS想用 JSP 快速把一张表的数据读出来展示在网页上做一个课堂作业、内部小工具或者原型 Demo。这份教程提供的正是这样一套完整可跑通的方案——一个 test.mdb 数据库、一张 username 表、一个 JDBCAccess.jsp 页面从建库到建表再到页面输出一步到位。但这里有个背景你必须先知道教程里用的驱动sun.jdbc.odbc.JdbcOdbcDriver是 JDBC-ODBC 桥它依赖本机 Windows 的 ODBC 数据源组件而且只有 32 位版本可用。如果你现在用的是 64 位 JDK、64 位 Tomcat按教程原样抄代码大概率会报ClassNotFoundException。所以这篇笔记不打算只复述代码我会把原理、搭建步骤、参数说明和踩坑记录一起拆完让你既能看懂这份老资源也能在自己的机器上真正跑通。2. 为什么用 JDBC-ODBC 桥原理、选型与 32/64 位环境准备2.1 JDBC-ODBC 桥的工作方式与历史原因JDBC-ODBC 桥是 Java 早期提供的一个驱动它的作用是把 JDBC 调用翻译成 ODBC 调用再由 ODBC 去访问具体的数据库。对 ACCESS 来说Access 本身不提供 JDBC 驱动而 Windows 系统自带 ODBC 驱动Microsoft Access Driver (*.mdb)所以桥接就成了最省事的路径。原理上是一条链JSP → JDBC API → JDBC-ODBC 桥 → ODBC Driver Manager → ACCESS 驱动 → .mdb 文件。这条链的好处是零配置依赖——只要 Windows 装了 Access 驱动Java 代码里写死驱动名就能连。坏处也很明显性能一般、只能在 Windows 上用、跨平台能力为零。JDK 1.8 开始官方已经移除了这个桥接驱动所以你还得注意 JDK 版本。教程原文用的是 Tomcat 6.0 配合老 JDK那是当时的标准组合现在复现我建议优先用 JDK 1.7 或者 1.8 的 32 位版本后面我会专门讲 64 位环境的替代方案。2.2 mdb 与 accdb文件格式决定连接串写法Access 2003 及更早版本生成的是.mdb文件Access 2007 之后默认生成.accdb文件。教程用的Driver{Microsoft Access Driver (*.mdb)}只认.mdb所以你在建库时要注意两点要么在 Access 另存为时手动选“Access 2000/2003 格式.mdb”要么新装 Access 2016/2019 后另存一次。很多人照着教程做失败原因就是自己用新版 Access 建出来的文件是.accdb驱动名根本不匹配。如果确实想用.accdb连接串要改成Driver{Microsoft Access Driver (*.mdb, *.accdb)}但这个驱动版本要看系统里装的是哪个 Access 驱动。最保险的做法是统一存成.mdb跟教程保持一致省得在驱动名上反复折腾。2.3 环境检查先确认 JDK、Tomcat 和 ODBC 驱动都是 32 位这一节是整个复现里最容易忽略的环节。JDBC-ODBC 桥是纯 32 位实现如果你装了 64 位 JDKClass.forName(sun.jdbc.odbc.JdbcOdbcDriver)这行就会直接抛异常因为 64 位 JVM 里根本没有这个类。检查方法很简单命令行窗口执行java -version如果输出里带有64-Bit字样说明当前默认 JDK 是 64 位。接着检查系统 ODBC 驱动管理器在控制面板里找到“ODBC 数据源32 位”和“ODBC 数据源64 位”两个入口只有 32 位那个能看到Microsoft Access Driver (*.mdb)。解决的路径有两条一是给 Tomcat 单独指定 32 位 JDK在catalina.bat里加一行set JAVA_HOMEC:\jdk32二是干脆用 32 位 JDK 跑整个开发环境。我个人更推荐第二条因为后续调试时 32 位 JDK 和 32 位 ODBC 驱动配合最省心JDK 版本选 1.7 或 1.8 的 32 位安装包都可以。3. 从建库到跑通test.mdb 的准备、Tomcat 目录与第一个可用页面3.1 创建 ACCESS 数据库和 username 表先用 Access 新建一个空数据库文件名存为test.mdb。这里有个细节新版 Access 默认存成.accdb保存时要在“文件类型”里手动选“Access 2002-2003 格式.mdb”。建库完成后在表设计视图里新建一张表username添加两个字段uid和pwd数据类型都选“短文本”长度保持默认 255 即可。然后随便插入两三条测试数据比如uidpwdadmin123456testabc123这步不要省后面 JSP 页面查不到数据的话你很难判断是连接问题还是表里没数据。我一般建议插 3 条以上这样能顺带验证rs.next()循环是否正常工作。3.2 把 mdb 文件放进 Tomcat 的 data 目录教程要求把test.mdb放到 Tomcat 安装目录下的webapps\ROOT\data文件夹里。这样做的目的是让 JSP 能通过application.getRealPath(data/test.mdb)拿到文件的绝对磁盘路径。你得先确认 Tomcat 的物理路径比如我自己机器上是D:\apache-tomcat-8.5.24\webapps\ROOT那就建一个data文件夹把test.mdb复制进去。注意一个容易出错的地方如果你不是把 JSP 放在ROOT下而是放在某个 Web 应用里路径要相应调整。比如应用名是demo那 mdb 就要放到webapps\demo\data\test.mdb代码里的相对路径data/test.mdb保持不变但getRealPath解析出来的位置会跟着应用走。部署到服务器后很多人在这里栽跟头建议先在本地把路径逻辑搞明白再上服务器。3.3 编写并部署 JDBCAccess.jsp在webapps\ROOT目录下新建一个JDBCAccess.jsp把下面的代码完整粘进去。注意编码声明用的是gb2312这是老教程的习惯如果你页面输出中文出现乱码可以改成UTF-8但必须保证页面的pageEncoding、charset和文件保存编码三者一致% page contentTypetext/html; charsetutf-8 languagejava importjava.sql.* % % try { String spath data/test.mdb; String dbpath application.getRealPath(spath); String url jdbc:odbc:Driver{Microsoft Access Driver (*.mdb)};DBQ dbpath; Class.forName(sun.jdbc.odbc.JdbcOdbcDriver); Connection conn DriverManager.getConnection(url); Statement stmt conn.createStatement(ResultSet.TYPE_SCROLL_SENSITIVE, ResultSet.CONCUR_UPDATABLE); String sql select * from username; ResultSet rs stmt.executeQuery(sql); while (rs.next()) { out.print(用户名: rs.getString(uid)); out.print( 密码: rs.getString(pwd) br); } out.print(br恭喜你数据库连接成功); rs.close(); stmt.close(); conn.close(); } catch (Exception e) { out.print(数据库连接错误错误信息如下br); out.print(e.getMessage()); } %代码逻辑不复杂spath定义相对路径getRealPath转成绝对路径然后拼出 ODBC 连接字符串。DBQ参数指定数据库文件位置是这整套连接的核心。加载驱动后DriverManager.getConnection建立连接用Statement执行查询并循环输出结果。最后别忘了rs.close()、stmt.close()、conn.close()虽然 JSP 页面结束后连接会被回收但养成关闭习惯对连接池场景很重要。4. JDBCAccess.jsp 逐段拆解连接串、语句对象与查询循环4.1 连接字符串的构造细节String url jdbc:odbc:Driver{Microsoft Access Driver (*.mdb)};DBQ dbpath;这行是整份资源最核心的一行拆开看是四部分jdbc:odbc:表示走 JDBC-ODBC 桥Driver指定 ODBC 驱动名注意驱动名带括号和大括号这是 ODBC 的语法要求不能去掉DBQ是数据库文件路径参数后面直接跟绝对路径。这样的写法叫“无 DSN 连接”好处是不用在系统里配置 ODBC 数据源路径写在代码里换台机器改路径就行。与之相对的是“DSN 连接”需要先在控制面板里配好数据源名称代码里写jdbc:odbc:testDSN虽然也可以但比无 DSN 多一步配置我一般不推荐在教程里用。还有个容易看走眼的点教程原文的连接串写的是Driver{Microsoft Access Driver (*.mdb)}但你敲代码时如果手动敲括号里的*.mdb很容易被输入法换成中文星号或者大括号被省略都会导致驱动加载失败。我建议直接复制代码不要手敲。4.2 Statement 创建时的两个参数含义Statement stmt conn.createStatement(ResultSet.TYPE_SCROLL_SENSITIVE, ResultSet.CONCUR_UPDATABLE);很多初学者不理解为什么这里要传两个参数。第一个TYPE_SCROLL_SENSITIVE表示结果集支持双向滚动也就是游标可以往前也可以往后移动第二个CONCUR_UPDATABLE表示结果集允许直接更新数据库中的数据。教程里查询后只做了while(rs.next())顺序遍历其实用默认参数也能跑但把这两个参数写上意味着你可以用rs.previous()往回翻甚至用rs.updateString()直接改表数据算是一种预留能力。这里我得提醒一句CONCUR_UPDATABLE在 JDBC-ODBC 桥下对 ACCESS 的兼容性并不完美有些环境会报“结果集不可更新”的警告。如果你只是做查询展示把第二个参数改成ResultSet.CONCUR_READ_ONLY更稳。这不是教程的错是老驱动的历史包袱遇到再改就行。4.3 while 循环取数与常见误用对比while (rs.next()) { out.print(用户名: rs.getString(uid)); out.print( 密码: rs.getString(pwd) br); }rs.next()每次执行会把游标移动到下一行同时返回布尔值表示是否还有数据。这里用getString(uid)按字段名取值等价于getString(1)。我见过有人把字段名写错成userid或者pass和表结构不一致运行时报Column not found。排查方法很简单打开 ACCESS 表设计视图核对字段名是否完全一致区分大小写在 ACCESS 中虽然不严格但建议和设计保持一致避免不同驱动版本下的行为差异。还有一个常见误用是试图在while循环里直接conn.close()这会在第一次循环后就把连接关掉导致后续迭代出错。连接、语句、结果集的关闭顺序一定是结果集 → 语句 → 连接而且全部放在循环结束之后。5. 避坑手册五个最容易翻车的细节5.1 现象ClassNotFoundException: sun.jdbc.odbc.JdbcOdbcDriver原因JDK 1.8 之后的版本已经移除了 JDBC-ODBC 桥驱动类或者你当前用的是 64 位 JDK类加载器找不到这个类。解决换成 32 位 JDK 1.7 或 1.8或者干脆跳过低版本 JDK 的坑直接用后面章节要讲的 UCanAccess 驱动。如果你导师要求必须用这个老驱动那就老老实实装 32 位 JDK并确保 Tomcat 的JAVA_HOME指向它。5.2 现象java.sql.SQLException: [Microsoft][ODBC 驱动程序管理器] 未发现数据源名称并且未指定默认驱动程序原因连接串里的驱动名写错了系统 ODBC 驱动列表里找不到Microsoft Access Driver (*.mdb)。常见原因有两个一是 Access 驱动没装Office 被精简安装二是你建的是.accdb文件但驱动写的是.mdb。解决先打开控制面板里的“ODBC 数据源32 位”在“驱动程序”选项卡里看有没有Microsoft Access Driver (*.mdb)。没有就重新安装 Office 的 Access 组件或者单独安装 Access 数据库引擎如果是.accdb文件把连接串驱动改成Microsoft Access Driver (*.mdb, *.accdb)。5.3 现象java.io.FileNotFoundException: data\test.mdb (系统找不到指定的路径)原因getRealPath(data/test.mdb)返回的路径不存在。大部分情况是 mdb 文件没放在正确的应用目录下或者 Tomcat 启动时还没部署完成。解决先确认文件确实在webapps\ROOT\data\下面再检查文件名大小写。这里再教你一个万能调试法在 JSP 里临时加一行out.print(dbpath);把解析出来的完整路径打出来复制到资源管理器里看能不能打开。这个习惯能省掉很多无谓的猜想。5.4 现象页面输出中文乱码原因JSP 声明的charsetgb2312与实际文件保存编码不一致或者 Tomcat 默认请求/响应的编码不是 UTF-8。解决把开头两行的gb2312全部改成utf-8同时用记事本另存为 UTF-8 编码确保页面文件本身的编码和声明一致。如果你还涉及到表单提交建议在 JSP 第一行加上request.setCharacterEncoding(UTF-8);这个设置在 Tomcat 8 以下版本特别重要。5.5 现象连接成功但查询返回 0 行页面不报错原因username表确实是空的或者你连的 mdb 文件和插入数据的 mdb 文件不是同一个——比如你往桌面上的副本插了数据Tomcat 读的是data目录下另一个文件。解决先检查data目录下 mdb 文件的大小和修改时间确定是同一份文件再进入 Access 确认表和数据存在。我自己就犯过这种低级错误当时两小时没排查出来最后发现是工作目录里放着三个同名 test.mdb。6. 64 位环境与永久替代方案UCanAccess 迁移实战如果你受够了 32 位 JDK 的限制或者你的项目已经跑在 JDK 8 及以上版本推荐直接切换到 UCanAccess。它是一个纯 Java 实现的 JDBC 驱动不依赖 ODBC32 位和 64 位都能用连接的是.mdb和.accdb文件而且驱动托管在 Maven 中央仓库用起来比桥接干净得多。核心改动只有两处驱动类名换成net.ucanaccess.jdbc.UcanaccessDriver连接串变成jdbc:ucanaccess://加文件路径。我一般会把数据库路径抽成常量避免散落各处Class.forName(net.ucanaccess.jdbc.UcanaccessDriver); Connection conn DriverManager.getConnection(jdbc:ucanaccess://D:/data/test.mdb);UCanAccess 依赖几个底层 jar 包如果用 Maven 管理项目在pom.xml里引入dependency groupIdnet.sf.ucanaccess/groupId artifactIducanaccess/artifactId version5.0.1/version /dependency非 Maven 项目就直接把 ucanaccess 和它的依赖包全放进WEB-INF/lib下。切换后Statement、ResultSet的用法和原来的 JDBC 代码完全一致不需要改查询逻辑这是我推荐它的最大原因——迁移成本极低。如果你连 UCanAccess 都懒得用但数据量真的很小我自己的习惯是再走一步把数据导入 SQLiteJSP 里用 SQLite JDBC 驱动连接。一个文件就是一个库部署路径规则和 mdb 一样但驱动的更新维护比 Access 活跃得多不会有版本失效的问题。从那以后我每次接手这类老资源都会先确认驱动在当前环境是否存活然后顺手把连接串和驱动名抽成单独的配置项强制走一遍“文件是否存在 → 驱动是否可加载 → 权限是否可读”三步检查再开始写业务代码。这套习惯帮我绕开了很多莫名其妙的环境坑希望帮到你。真正跑通之后你会发现 JSP 连接 ACCESS 数据库这套流程本身不难难点全在环境适配和路径细节上。这份资源的价值不在于代码有多高深而在于它把整条链路完整走了一遍你照着做一遍至少能把 JDBC 连接、ODBC 驱动、路径解析这几件事彻底搞明白以后再换 MySQL 或 SQL Server思路都是相通的。本文还有配套的精品资源点击获取

JSP连接ACCESS数据库全攻略：从JDBC-ODBC桥到UCanAccess迁移

相关推荐

微前端通用请求层设计：从鉴权到错误码归一的标准实践

UQLab Core模块安装与实战：不确定性量化与采样避坑指南

PaddleOCR微调导出模型权重加载失效：从环境到导出的完整避坑指南

更多资讯

Qwen1.5-7B-Chat_rai_1.8.0_medusa_1.0_npu 部署到 NPU：AMD 端侧推理完整实践教程

2026年2月Product Hunt热榜解析：AI Agent与端侧智能引领趋势

国产算力地基开源：算子库、通信库与图编译如何填平软硬协同鸿沟

WAM具身智能框架：AHA-WAM引擎、Wan权重与RoboTwin协议实战指南

2026 AI技术栈全景拆解：从大模型到AI Agents的实战路径

Atoll 2.8 LTE仿真操作指南：从地图配置到网络性能预测全解析

今日更新

Cephadm实战指南：Linux系统工程师的生产级Ceph集群部署与排障

不想再被 Token 额度卡脖子？把免费 API 接入 WorkBuddy 的完整教程

ITK中SpatialObject几何体系解析：坐标系、变换与管道集成

本周精选

交通拥堵预测毕设：基于Python+LSTM的车辆流量预测系统全流程解析

MATLAB/Simulink搭建10机39节点电力系统暂态稳定仿真实战

无人机航拍三维重建全流程：从SfM到网格生成的避坑指南

本月热门

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

读完文章，想聊聊您的网站？