简介本资源是一份面向Web开发初学者与高校教学实践的JSP数据库连接入门教程聚焦JSP通过JDBC-ODBC桥接方式连接ACCESS数据库的核心流程解决小型项目或实验环境中数据存取的基础需求。压缩包为单个31KB的Word文档.doc完整呈现了从创建test.mdb数据库、设计username表结构到配置Tomcat路径、编写含异常处理的JDBCAccess.jsp代码的全流程含关键注释、连接字符串构造逻辑、资源释放规范及常见错误提示说明。文档内容与代码节选高度一致步骤清晰、参数可复用特别适合零基础理解JDBC驱动加载、Connection/Statement/ResultSet生命周期管理等核心概念。目前已有240人学习下载是掌握Java Web数据交互底层原理的轻量级实操范例。1. JSP连接ACCESS数据库一个被时代封印但必须亲手拆解的“古董级”数据链路你可能在某高校实验室的旧机房里见过它一台 Windows XP 的老电脑屏幕右下角托盘还挂着杀毒软件的弹窗IE6 浏览器打开一个地址http://localhost:8080/JDBCAccess.jsp页面上赫然打印出「用户名:admin 密码:123456」——没有加密、没有校验、没有 Spring、没有 MyBatis只有一段裸写的Class.forName(sun.jdbc.odbc.JdbcOdbcDriver)像一枚生锈却仍能转动的齿轮在 Tomcat 6.0 的蒸汽锅炉里咬合着 Access 2003 的.mdb文件。这不是怀旧是真实存在的技术断层现场JSP 连接 ACCESS 数据库至今仍是某高校《Web 程序设计》课程实验报告里高频出现的必做项也是某公司遗留的内部资产登记系统仍在跑的底层逻辑。它不适用于生产环境但它是理解 JDBC 原始契约、ODBC 桥接机制、Web 容器资源路径解析的最短路径——因为所有抽象都被剥掉了只剩驱动、URL、Connection、Statement 四个词在裸奔。如果你正被导师要求“用 JSP 读取本地 mdb”或接手了一个十年前部署在内网 WinServer 上的审批小系统这篇笔记就是你跳过玄学报错、直通恭喜你数据库连接成功的操作地图。我们不美化它也不淘汰它我们把它当做一个黑匣子撬开盖子看清每根线怎么焊上去的。2. 技术栈与运行环境为什么是 JSP ACCESS ODBC而不是别的组合2.1 为什么非得是这个“三件套”历史包袱与轻量刚需的硬性匹配JSPJava Server Pages在 2000 年代初是 Java Web 开发的事实标准它把 Java 代码嵌在 HTML 里适合教学演示和快速原型。而 Microsoft Access 是 Windows 自带的桌面级关系型数据库.mdb文件即数据库无需安装服务、无需配置用户权限双击就能编辑——这对学生实验、部门级小工具、离线单机系统来说是零门槛的数据存储方案。两者之间缺一座桥Java 原生不支持直接读.mdbAccess 也不提供原生 JDBC 驱动。于是 JDK 1.2 起内置的sun.jdbc.odbc.JdbcOdbcDriver就成了唯一合法通道它把 JDBC 调用翻译成 ODBC API 调用再由 Windows 系统自带的Microsoft Access Driver (*.mdb)即odbcjt32.dll去真正打开文件。这不是架构选择是平台能力的物理限制——就像你不能让 USB-A 插口直接连 Type-C 设备必须用转接头。今天你用 Spring Boot H2 也能实现同样功能但那会掩盖掉“驱动加载”“物理路径解析”“ODBC 连接字符串语法”这些底层契约。而本项目的价值恰恰在于它强迫你直面这些契约。2.2 环境版本不是可选项而是执行前提Tomcat 6.0 JDK 1.6 Windows XP/7 是黄金三角这段代码绝不是“写完就能跑”。它对运行时环境有刚性依赖Tomcat 版本必须 ≤ 7.0sun.jdbc.odbc.JdbcOdbcDriver在 JDK 8 中被标记为DeprecatedJDK 9 彻底移除。Tomcat 8 默认使用 JDK 8驱动类根本不存在。实测Tomcat 6.0.39配 JDK 1.6.0_45稳定运行Tomcat 7.0.99配 JDK 1.7.0_80需手动复制rt.jar中的sun.jdbc.odbc.*类不推荐Tomcat 8.5 无法启动。操作系统必须是 WindowsODBC Driver 是 Windows 系统组件Linux/macOS 没有Microsoft Access Driver (*.mdb)。即使你装了 Wine 或模拟器ODBC 层调用会因 DLL 加载失败而崩溃。JDK 必须是 32 位或 64 位严格匹配Windows 上的 Access Driver 分 32 位和 64 位版本。若你的 Tomcat 是 32 位默认JDK 也必须是 32 位否则System.loadLibrary(odbcjt32)会抛UnsatisfiedLinkError。检查方法命令行执行java -version末尾带Mixed mode, sharing且无64-Bit字样即为 32 位。提示不要试图在 macOS 或 Linux 上“绕过”这个限制。网上所谓“用 UCanAccess 替代”的方案本质是引入纯 Java 的 Access 解析库已脱离本项目原始技术栈范畴。本文只解决“按原始代码跑通”的问题。2.3 数据库路径解析application.getRealPath()是 JSP 时代的“相对路径翻译器”代码中这行String dbpath application.getRealPath(spath);是关键中的关键。spath data/test.mdb是 Web 应用内的虚拟路径类似浏览器访问/data/test.mdb而getRealPath()把它翻译成服务器磁盘上的绝对物理路径比如C:\Program Files\Apache Software Foundation\Tomcat 6.0\webapps\ROOT\data\test.mdb。这个翻译动作依赖于 Servlet 容器Tomcat的部署结构webapps\ROOT\是默认 Web 应用根目录data/是你手动创建的子文件夹。如果把test.mdb直接丢进webapps\ROOT\根目录spath就该写成test.mdb如果放在webapps\myapp\data\下则spath是data/test.mdb且 JSP 文件必须放在myapp应用下。路径错误的典型现象是java.sql.SQLException: [Microsoft][ODBC Microsoft Access Driver] 未发现数据源名称并且未指定默认驱动程序——因为dbpath解析出来是个空字符串或错误路径ODBC 驱动根本找不到文件。2.4 连接字符串语法jdbc:odbc:Driver{...};DBQ...的每个字符都不能错ODBC 连接字符串是本项目最易翻车的黑匣子。代码中这行String url jdbc:odbc:Driver{Microsoft Access Driver (*.mdb)};DBQ dbpath;必须逐字核对jdbc:odbc:是协议前缀不可写成jdbc:odbc:driver小写或jdbc:odbc driver少冒号{Microsoft Access Driver (*.mdb)}是 Windows ODBC 数据源名称DSN的驱动名不是文件名。它必须与控制面板 → 管理工具 → 数据源 (ODBC) → 驱动程序页签中列出的名称完全一致包括括号、星号、空格。Win7/XP 默认存在Win10/11 可能需要手动启用“Microsoft Access Database Engine”从微软官网下载AccessDatabaseEngine.exe安装DBQ后跟的是完整物理路径且路径中不能有中文、空格、特殊符号如,#。若路径含空格如Program Files必须用双引号包裹整个DBQ参数即String url jdbc:odbc:Driver{Microsoft Access Driver (*.mdb)};DBQ\ dbpath \;否则 ODBC 解析器会在空格处截断路径报错Could not find installable ISAM。3. 项目结构与文件部署5 个文件决定成败少一个就 500 错误3.1 标准目录结构ROOT 应用下的最小可行部署树本项目不需要 WAR 包、不需要WEB-INF、不需要web.xml。它是一个极简的“静态 Web 应用”结构如下以 Tomcat 6.0 默认路径为例C:\Program Files\Apache Software Foundation\Tomcat 6.0\ └── webapps\ └── ROOT\ ← Tomcat 默认 Web 应用根目录 ├── JDBCAccess.jsp ← 主 JSP 页面必须 UTF-8 或 GB2312 编码 └── data\ └── test.mdb ← Access 数据库文件必须是 .mdb不是 .accdb注意ROOT文件夹名不能改这是 Tomcat 的约定。若你改名为myapp则访问地址变为http://localhost:8080/myapp/JDBCAccess.jsp且spath必须同步改为data/test.mdb因为myapp成了新根data文件夹必须手动创建Tomcat 不会自动建它test.mdb必须是 Access 2003 格式*.mdb不是 Access 2007 的.accdb。用 Access 2007 创建时务必在“另存为”对话框中选择“Access 2002-2003 数据库(.mdb)”格式JDBCAccess.jsp文件编码必须与% page contentTypetext/html; charsetgb2312 %声明一致。若用 UTF-8 编辑保存但声明写gb2312中文会乱码反之亦然。推荐统一用 GB2312Windows 简体中文默认编码避免跨平台问题。3.2 Access 数据库建表实操username表的字段定义与数据录入打开 Microsoft Access任意版本2003/2007/2010 均可新建空白数据库保存为test.mdb路径即上文data/下。然后创建表字段名称数据类型字段大小说明uid文本50用户名主键可选非必须pwd文本50密码明文存储仅测试注意Access 中“文本”类型对应 SQL 的VARCHAR字段大小设为 50 是安全值避免超长截断。不要用“备注”类型——rs.getString()无法读取备注字段会返回null。建好表后切换到“数据表视图”手动录入几条测试数据uid | pwd --------|-------- admin | 123456 user1 | abc123 test | pass保存并关闭 Access。此时test.mdb已包含有效数据等待 JSP 调用。3.3 JSP 文件核心代码逐行解析从Class.forName到conn.close()下面是对JDBCAccess.jsp中数据库操作部分的逐行拆解省略 HTML 头部和异常处理外壳% // 1. 定义数据库虚拟路径相对于 Web 应用根目录 String spath data/test.mdb; // 2. 转换为服务器磁盘绝对路径关键 String dbpath application.getRealPath(spath); // 3. 构造 ODBC 连接字符串Driver 名必须与系统 ODBC 驱动列表完全一致 String url jdbc:odbc:Driver{Microsoft Access Driver (*.mdb)};DBQ dbpath; // 4. 加载 JDBC-ODBC 桥接驱动JDK 内置无需额外 jar Class.forName(sun.jdbc.odbc.JdbcOdbcDriver); // 5. 建立数据库连接无用户名密码Access 文件级认证 Connection conn DriverManager.getConnection(url); // 6. 创建可滚动、可更新的 StatementTYPE_SCROLL_SENSITIVE 允许 rs.previous() Statement stmt conn.createStatement(ResultSet.TYPE_SCROLL_SENSITIVE, ResultSet.CONCUR_UPDATABLE); // 7. 执行查询SQL 语句必须与 Access 表名、字段名大小写无关但拼写必须精确 String sql SELECT * FROM username; ResultSet rs stmt.executeQuery(sql); // 8. 遍历结果集用字段名获取值比 rs.getString(1) 更健壮 while(rs.next()) { out.print(用户名: rs.getString(uid)); // uid 是字段名非变量名 out.print( 密码: rs.getString(pwd) br); } out.print(br恭喜你数据库连接成功); // 9. 必须显式关闭资源JSP 中无 try-with-resources易忘 rs.close(); stmt.close(); conn.close(); %关键参数说明ResultSet.TYPE_SCROLL_SENSITIVE表示结果集可前后滚动支持rs.first(),rs.last(),rs.previous()且对数据库变更敏感本例中无并发更新可忽略ResultSet.CONCUR_UPDATABLE表示结果集可更新本例未用rs.updateString()但声明了便于后续扩展rs.getString(uid)用字段名而非索引取值避免因SELECT *字段顺序变化导致的错位Access 中SELECT *字段顺序固定为建表顺序。3.4 部署后验证三步确认法比看浏览器更可靠别急着刷新浏览器。先做三步本地验证检查文件是否存在在命令行执行dir C:\Program Files\Apache Software Foundation\Tomcat 6.0\webapps\ROOT\data\test.mdb确认文件存在且大小 0KB检查 Tomcat 日志启动 Tomcat 后查看logs\catalina.out或logs\localhost.date.log搜索JDBCAccess.jsp确认无ClassNotFoundException或NoClassDefFoundError驱动加载失败Telnet 测试端口telnet localhost 8080若连接成功说明 Tomcat HTTP 服务正常若失败检查conf\server.xml中Connector port8080是否被注释或改端口。只有这三步都通过才去浏览器访问。否则 500 错误大概率是环境或路径问题不是代码逻辑问题。4. 常见问题排查血泪经验总结的 5 条高频翻车点4.1 现象页面显示“数据库连接错误,错误信息如下[Microsoft][ODBC Microsoft Access Driver] 未发现数据源名称并且未指定默认驱动程序”原因url字符串中的Driver{...}名称与 Windows 系统实际安装的 ODBC 驱动名不一致。常见错误包括写成{Microsoft Access Driver (*.accdb)}.accdb 驱动、{Microsoft Access Driver}缺(*.mdb)、或大小写错误如access小写。解决打开控制面板 → 管理工具 → 数据源 (ODBC) → 驱动程序页签逐字复制驱动名称含括号和星号粘贴到 JSP 的url字符串中。4.2 现象页面空白或只显示 HTML 头部无任何out.print输出Tomcat 日志报java.lang.NoClassDefFoundError: sun/jdbc/odbc/JdbcOdbcDriver原因JDK 版本 ≥ 8sun.jdbc.odbc.*类已被移除或 Tomcat 使用的 JDK 与你命令行java -version显示的不一致如系统 PATH 指向 JDK 8但 Tomcatbin\setenv.bat指向 JDK 6。解决确认 Tomcat 使用的 JDK 版本。编辑bin\setenv.bat若不存在则新建添加set JAVA_HOMEC:\Program Files\Java\jdk1.6.0_45 set JRE_HOME%JAVA_HOME%\jre重启 Tomcat并在日志中搜索JVM Vendor确认生效。4.3 现象报错java.sql.SQLException: [Microsoft][ODBC Microsoft Access Driver] 无法找到可安装的 ISAM原因dbpath解析出的物理路径含空格如Program Files但url字符串未用双引号包裹DBQ参数ODBC 解析器将路径在空格处截断。解决修改url构造逻辑强制加双引号String url jdbc:odbc:Driver{Microsoft Access Driver (*.mdb)};DBQ\ dbpath \;并确保dbpath字符串本身不含非法字符如,%。4.4 现象页面显示“用户名:null 密码:null”或rs.getString(uid)返回null原因Access 表中字段名与 JSP 代码中rs.getString(xxx)的字符串不一致如建表时字段叫user_id代码却写uid或字段数据类型错误如用了“备注”类型而非“文本”或数据库文件被其他程序如 Access独占锁定。解决用 Access 打开test.mdb右键表 → “设计视图”确认字段名拼写将字段类型改为“文本”关闭所有 Access 窗口重启 Tomcat。4.5 现象首次访问正常刷新后报错java.sql.SQLException: [Microsoft][ODBC Microsoft Access Driver] 不能打开注册表项或连接超时原因Access 数据库文件被多个线程同时读写ODBC 驱动在 Windows 下对.mdb文件的并发访问支持极差极易锁死。JSP 页面每次请求都新建连接无连接池高并发下必然崩溃。解决这不是 Bug是设计局限。本项目仅适用于单用户、低频访问场景如教学演示。若需多用户必须重构用 UCanAccess纯 Java 驱动替代 ODBC或迁移到 SQLite/MySQL。临时缓解在finally块中确保conn.close()执行避免连接泄漏。5. 核心模块拆解JdbcOdbcDriver的加载与连接建立的完整链路5.1Class.forName()的真实作用触发静态代码块注册驱动到DriverManagerClass.forName(sun.jdbc.odbc.JdbcOdbcDriver)这行代码常被误解为“只是加载类”。它的核心作用是触发该类的静态初始化块从而向java.sql.DriverManager注册一个驱动实例。查看JdbcOdbcDriver源码JDK 1.6src.zip中可知public class JdbcOdbcDriver implements java.sql.Driver { static { try { DriverManager.registerDriver(new JdbcOdbcDriver()); } catch (SQLException var1) { throw new RuntimeException(Cant register driver!); } } // ... 其他方法 }当Class.forName()执行时JVM 加载该类并运行其static{}块new JdbcOdbcDriver()创建驱动对象并调用DriverManager.registerDriver()。此后DriverManager.getConnection(url)才能根据url前缀jdbc:odbc:匹配到已注册的驱动。若跳过Class.forName()getConnection()会抛SQLException: No suitable driver found for jdbc:odbc:...。这是 JDBC 3.0 之前的经典注册方式JDBC 4.0 支持META-INF/services/java.sql.Driver自动发现但JdbcOdbcDriver未实现此机制。5.2DriverManager.getConnection()的内部流程URL 解析、驱动匹配、物理连接DriverManager.getConnection(url)并非直接创建连接而是委托给已注册的驱动。其内部流程如下遍历DriverManager维护的drivers列表即JdbcOdbcDriver实例对每个驱动调用acceptsURL(url)方法传入jdbc:odbc:Driver{...};DBQ...JdbcOdbcDriver.acceptsURL()解析url确认协议为jdbc:odbc:返回true调用该驱动的connect(url, info)方法info为空Access 无用户密码JdbcOdbcDriver.connect()创建JdbcOdbcConnection对象内部调用 Windows APISQLAllocHandle(SQL_HANDLE_ENV)和SQLConnect()最终由odbcjt32.dll打开.mdb文件。这个过程暴露了 ODBC 桥接的本质Java 层只是胶水真正的数据库操作由 Windows 系统 DLL 完成。这也是它无法跨平台的根本原因。5.3Statement创建参数的意义TYPE_SCROLL_SENSITIVE与CONCUR_UPDATABLE的取舍conn.createStatement(ResultSet.TYPE_SCROLL_SENSITIVE, ResultSet.CONCUR_UPDATABLE)中两个参数决定了ResultSet的行为TYPE_SCROLL_SENSITIVE结果集可滚动rs.next(),rs.previous(),rs.absolute(5)且对数据库变更敏感若其他连接修改了数据rs可能反映变化。但 Access 的.mdb文件不支持真正的事务隔离此“敏感”在实践中几乎无效。教学建议初学者用TYPE_FORWARD_ONLY仅向前滚动更安全性能更好代码改为Statement stmt conn.createStatement(ResultSet.TYPE_FORWARD_ONLY, ResultSet.CONCUR_READ_ONLY);CONCUR_UPDATABLE结果集可更新支持rs.updateString(),rs.updateRow()。但 Access 的 ODBC 驱动对此支持不稳定常报Operation not allowed。生产建议读取场景一律用CONCUR_READ_ONLY写入用单独的PreparedStatement。5.4application.getRealPath()的容器依赖为什么它在 Tomcat 外无法工作application是 JSP 的内置对象类型为javax.servlet.ServletContext。getRealPath(String path)方法的实现依赖于 Servlet 容器的具体部署方式在 Tomcat 中它返回webapps\ROOT\下的绝对路径在 Jetty 或 WebLogic 中若应用以 WAR 包形式部署且未解压getRealPath()可能返回null因为文件在 WAR 包内无物理路径在独立 Java 程序中根本没有ServletContext此方法根本不存在。因此getRealPath()是典型的“容器绑定 API”。若你想让代码更具移植性应改用ServletContext.getResourceAsStream(/data/test.mdb)获取InputStream但 Access 驱动不接受流只接受文件路径——这再次证明本项目与 Tomcat Windows 的强耦合是设计使然无法优雅解耦。6. 二次开发改造指南从“能跑”到“能用”的 3 个实战技巧6.1 技巧一用PreparedStatement防 SQL 注入哪怕只是 demo原始代码用String sql SELECT * FROM username是安全的但一旦要加条件如WHERE uidadmin拼接字符串就会引入 SQL 注入风险。改造为PreparedStatement只需两步% // ... 连接建立后 String sql SELECT * FROM username WHERE uid ? AND pwd ?; PreparedStatement pstmt conn.prepareStatement(sql); pstmt.setString(1, request.getParameter(uid)); // 从表单获取 pstmt.setString(2, request.getParameter(pwd)); ResultSet rs pstmt.executeQuery(); if (rs.next()) { out.print(登录成功欢迎 rs.getString(uid)); } else { out.print(用户名或密码错误); } rs.close(); pstmt.close(); // 记得关闭 PreparedStatement %关键点?占位符由驱动自动转义杜绝 OR 11类攻击pstmt.setString(1, ...)的索引从 1 开始不是 0PreparedStatement比Statement更高效预编译适合重复执行。6.2 技巧二封装数据库工具类告别重复的try-catch-finally把连接、关闭逻辑抽成工具类避免每个 JSP 都写冗长的资源管理。创建DBUtil.java放在WEB-INF\classes\下package util; import java.sql.*; public class DBUtil { private static final String DRIVER sun.jdbc.odbc.JdbcOdbcDriver; private static final String URL jdbc:odbc:Driver{Microsoft Access Driver (*.mdb)};DBQ; static { try { Class.forName(DRIVER); } catch (ClassNotFoundException e) { throw new RuntimeException(JDBC-ODBC Driver not found, e); } } public static Connection getConnection(String dbpath) throws SQLException { return DriverManager.getConnection(URL \ dbpath \); } public static void close(AutoCloseable... resources) { for (AutoCloseable r : resources) { if (r ! null) { try { r.close(); } catch (Exception e) { // 记录日志但不抛出避免掩盖主异常 } } } } }在 JSP 中调用% page importutil.DBUtil, java.sql.* % % String dbpath application.getRealPath(data/test.mdb); Connection conn null; PreparedStatement pstmt null; ResultSet rs null; try { conn DBUtil.getConnection(dbpath); pstmt conn.prepareStatement(SELECT * FROM username); rs pstmt.executeQuery(); while (rs.next()) { out.print(用户名: rs.getString(uid) br); } } finally { DBUtil.close(rs, pstmt, conn); // 一行关闭所有 } %优势资源关闭逻辑集中不易遗漏驱动加载只做一次close()方法用AutoCloseable接口兼容Connection/Statement/ResultSet。6.3 技巧三用ServletContextListener预热连接规避首次访问延迟JSP 第一次访问时Class.forName()和DriverManager.getConnection()会触发类加载和 DLL 初始化造成明显卡顿1-2 秒。用ServletContextListener在 Tomcat 启动时就建立并缓存一个连接// WEB-INF\classes\util\DBInitListener.java package util; import javax.servlet.*; import java.sql.Connection; public class DBInitListener implements ServletContextListener { Override public void contextInitialized(ServletContextEvent sce) { ServletContext ctx sce.getServletContext(); try { String dbpath ctx.getRealPath(data/test.mdb); Connection conn DBUtil.getConnection(dbpath); // 将连接存入 application 域不推荐生产仅 demo ctx.setAttribute(dbConnection, conn); ctx.log(Database connection pre-initialized); } catch (Exception e) { ctx.log(Failed to pre-init DB connection, e); } } Override public void contextDestroyed(ServletContextEvent sce) { ServletContext ctx sce.getServletContext(); Connection conn (Connection) ctx.getAttribute(dbConnection); if (conn ! null) { try { conn.close(); } catch (Exception e) {} } } }并在WEB-INF\web.xml中注册listener listener-classutil.DBInitListener/listener-class /listener注意此技巧仅降低首次访问延迟不解决并发问题。Access 文件锁依然存在多用户同时写入仍会失败。真正的高并发方案是换数据库而非优化连接初始化。从那以后我每次接手一个老系统第一件事就是查web.xml里有没有ServletContextListener第二件事是翻lib目录找odbc相关的 jar——如果看到ucanaccess-5.0.1.jar我就知道这是个现代改造过的版本如果只看到空荡荡的WEB-INF\classes和一段sun.jdbc.odbc我就默默打开 Windows 虚拟机装好 JDK 1.6 和 Access 2003。技术没有高低只有适配场景。JSP 连 Access 是过时的但它是理解“数据如何从磁盘走到浏览器”的最短路径。希望帮到你。本文还有配套的精品资源点击获取