简介这是一款面向Java Web学习者的客户管理系统项目基于JSP、Servlet与MySQL数据库实现采用B/S架构前端融合Layui、jQuery等常用技术适合作为课程设计、毕业设计或企业级客户管理模块的起步参考。系统围绕客户全生命周期设计了登录、客户管理、线索管理、交易管理、联系人管理、系统管理、市场管理和数据统计等功能覆盖从线索获取到最终成交的典型业务路径。整套资源共含六百九十七个文件压缩包约二十三点零六兆类型涵盖Java源码、JSP页面、XML配置、JS/CSS前端资源、SQL脚本及操作演示GIF等目录结构清晰便于按功能模块检索。目前已有169人学习下载具备一定参考价值。通过研读该项目可以深入理解Servlet控制层、MyBatis持久化、Layui界面布局以及客户数据流转方式并可直接导入开发工具运行与扩展是提升Java Web开发能力的实用素材。1. 一套只有 .class 文件的 JSPServlet 客户管理系统值得跑起来的真实原因拿到这套资源的第一眼确实容易劝退压缩包里躺着一堆ClueController.class、UserController.class、TranController.class没有完整源码没有 README连数据库脚本都要自己到文档里翻。但你把它当成「能直接导入 IDEA 跑出效果的 JavaWeb 完整案例」来看就亏了——它的价值恰恰在于这是一个典型 B/S 架构的 CRM客户关系管理系统覆盖了登录、线索跟踪、交易管理、数据统计这一整条业务链路后端用 JSPServletMyBatis前端用 Layui 全家桶数据库 MySQL5.7 起Tomcat8 起。适合三类人准备毕设的专科/本科生需要一套能讲清楚模块的 JavaWeb 项目刚学完 Servlet 和 MyBatis 但没见过完整项目长什么样的初学者以及公司内部想拿一套 CRUD 模板快速改业务的开发。本文带你把它从一堆字节码跑成一个能登录、能点点点的真实系统。2. 拆解这套 CRM 的架构模块分层、路由映射与数据库设计2.1 JSPServletMyBatis 这个组合为什么到现在还在用先说架构选型。你可能会问都什么年代了为什么不用 Spring Boot这套项目选的是 JSPServletMyBatis 的经典组合背后有三层考虑。第一Servlet 是 JavaWeb 的根Spring MVC 的 DispatcherServlet 本身就是基于 Servlet 规范做的封装把这套东西跑明白后面看 Spring 的请求流转会非常轻松。第二JSP 直出页面对新手来说「浏览器刷新一下改动立刻可见」调试成本远低于前后端分离的工程。第三MyBatis 在这里只是个 SQL 映射工具没有 Spring 托管因此你反而能看清Mapper接口、SqlSessionFactory、xml映射文件三者之间是怎么手动捏合在一起的。这套项目采用 B/S 架构也就是浏览器/服务器模式你在浏览器里打开http://localhost:8080/crm/login.jsp请求打到 TomcatTomcat 根据web.xml里的映射把请求交给对应的 ControllerServletController 调用 DAO 层拿数据再forward回 JSP 渲染页面回显。整个过程走的是「请求 → Servlet → Service → DAO → MySQL → 返回 JSP」这条链路。理解了这条线后面排查任何问题都有方向。2.2 功能模块清单登录、客户、线索、交易、联系人和系统管理从类名和资料里的功能描述来看这套 CRM 的核心模块可以拆成这样一张表你跑起来之后照着它逐项去点很快能对上每个后台类的作用。模块对应后端类核心功能登录认证UserController账号密码校验、Session 管理、退出登录线索管理ClueController线索新增、线索转客户、线索跟进记录客户管理ContactsController客户信息增删改查、联系人维护、客户分类交易管理TranController交易创建、交易阶段推进、金额统计市场活动ActivityController市场活动登记、活动效果分析数据统计统计类 Servlet按客户来源、交易金额等维度出图表值得注意的是线索Clue和客户Contacts在业务上是两套数据表线索是「还没建立正式关系」的潜在商机转换成客户后才会走到交易Tran这条链路上。很多初学 CRM 项目的人会把线索和客户混在一张表里这个项目把它们拆开了这在答辩或讲解时是一个可以主动讲的亮点。数据统计模块通常会按交易金额和客户来源做 group by 聚合对应到 SQL 上就是SELECT source, COUNT(*) FROM t_customer GROUP BY source这类语句。2.3 用 javap 从字节码反推后端路由没有 .java 也能看懂的套路这套资源只给了.class文件没有.java很多人拿到手就愣住了以为必须去网上下一个反编译器才能看。其实 JDK 自带javap直接可以看字节码够你做路由分析。执行路径是打开命令行进入项目编译后的WEB-INF/classes目录然后运行javap -p -c com.company.controller.UserController-p表示显示所有成员包括 private-c表示输出字节码指令。你会看到类似aload_0、invokevirtual这样的指令序列但这还不够直观。更实用的做法是用javap -verbose看类和方法签名比如想看这个 Controller 里有哪些方法、方法接收什么参数、返回什么类型javap -verbose com.company.controller.UserController | findstr publicfindstr public是 Windows 下的过滤命令Linux/macOS 换成grep public即可。从输出里你能筛出doGet、doPost、login、logout这些方法名再结合WEB-INF/web.xml里的servlet-mapping配置就能拼出「哪个 URL 打在哪个方法上」的路由地图。如果你想把字节码还原成可读的 Java 源码常见做法是用 CFR 这类反编译工具一条命令就能生成 .java 文件java -jar cfr.jar com/company/controller/UserController.class UserController.java参数说明cfr.jar是反编译器本体后面跟的是字节码文件的相对路径表示把反编译结果输出到指定文件。从反编译代码里你可以直接看到request.getParameter(username)、response.sendRedirect(index.jsp)这样的原生写法和手写 Servlet 几乎一样所以这套资源对学习 Servlet 的人非常友好反编译出来的代码基本能读。关于 JSP 图片路径定位项目里会用相对路径../images/xxx.png或绝对路径/crm/images/xxx.png如果你把项目名改了所有绝对路径都容易 404这个后面在避坑章节细说。2.4 数据库表结构设计先建库建表再谈业务整套系统的数据支撑是 MySQL资料里要求 MySQL5.7 及以上。常见的表设计会包含用户表、客户表、线索表、交易表、联系人和市场活动表外键一般用customer_id、clue_id、user_id串联。给你一段建库和建用户表的参考脚本实际以你下载到的 SQL 文件为准CREATE DATABASE IF NOT EXISTS crm DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE crm; CREATE TABLE t_user ( id INT(11) NOT NULL AUTO_INCREMENT, username VARCHAR(50) NOT NULL COMMENT 登录名, password VARCHAR(64) NOT NULL COMMENT 密码MD5加密后存储, real_name VARCHAR(50) DEFAULT NULL COMMENT 真实姓名, role VARCHAR(20) DEFAULT admin COMMENT 角色, PRIMARY KEY (id) ) ENGINEInnoDB AUTO_INCREMENT1 DEFAULT CHARSETutf8mb4; INSERT INTO t_user (username, password, real_name, role) VALUES (admin, MD5(123456), 系统管理员, admin);参数说明utf8mb4是必须的MySQL 的utf8实际只有 3 字节遇到生僻字或 Emoji 会报Incorrect string value错误MD5 加密只是演示级别生产环境你得换成 BCrypt但在这个项目里用 MD5 反而方便你在 SQL 里直接查明文对应关系便于调试。InnoDB引擎支持事务交易模块的金额操作最好依赖它。这条 SQL 里我给出的admin/123456是常规初始化账号具体账号以你资源里的文档或 .sql 脚本为准如果跑起来登录不进去优先去t_user表查记录。3. 从安装到启动JDK8、MySQL5.7.44、Tomcat8 与 IDEA 导入全步骤3.1 JDK1.8 和 Tomcat8别小看版本匹配这决定了你能否启动这套资源要求 JDK1.8、Tomcat8.0 及以上。为什么非要 JDK8因为 Servlet 3.1 规范是 Tomcat8 实现的而 Servlet 3.1 正好是 JDK7/8 时代的产物JDK 高版本比如 17跑 Tomcat8 经常会出现UnsupportedClassVersionError或者反射权限问题。所以最省事的配置是JDK8 Tomcat8.5 MySQL5.7。JDK 安装时注意两点一是安装路径不要带空格和中文否则后续 IDEA 和 Maven 都可能抽风二是JAVA_HOME和PATH环境变量必须配Tomcat 启动脚本就是靠JAVA_HOME找 java 可执行文件的。可以用下面这条命令验证 JDK 是否装好java -version看到java version 1.8.0_xxx即表示 OK。如果你的机器上有多个 JDK 版本先确认java -version指向的是 1.8如果不是去系统环境变量里把JAVA_HOME和PATH排到最前面或者干脆把高版本 JDK 的路径从PATH里暂时拿掉。Tomcat 8.5 下载解压后直接到bin目录双击startup.bat能弹出黑窗口说明基础环境就绪如果闪退走后面避坑章节的日志排查法。3.2 MySQL 5.7 安装解压版配置 my.ini 与初始化 data 目录MySQL 安装常见有两条路图形安装版和解压版。推荐解压版便于你直观察看配置排查起来反而更快。下载 MySQL 5.7.44 解压版放到如D:\mysql-5.7.44-winx64在该目录下新建my.ini文件[mysqld] basedirD:/mysql-5.7.44-winx64 datadirD:/mysql-5.7.44-winx64/data port3306 character-set-serverutf8mb4 default-storage-engineINNODB [client] default-character-setutf8mb4配置说明port默认 3306如果本机已有 MySQL 或者端口被占用改成 3307 再配一个port3307即可datadir指向解压目录下的 data 文件夹这个文件夹不能手动创建必须通过初始化命令生成否则服务启动会直接报错。保存后以管理员身份打开命令行进入 MySQL 的 bin 目录执行mysqld --initialize-insecure--initialize-insecure表示初始化数据目录且 root 账号初始密码为空方便你第一次登录直接设新密码。初始化完成后继续在 bin 目录注册 Windows 服务并启动mysqld install MySQL57 net start MySQL57install MySQL57是把 MySQL 注册成一个名为 MySQL57 的 Windows 服务之后开机自启net start MySQL57是立即启动。如果你不想注册服务也可以直接mysqld --console在前台启动但关掉窗口服务就停了调试阶段没问题日常用还是建议装服务。启动成功后进入客户端用空密码登录并修改 root 密码mysql -u root ALTER USER rootlocalhost IDENTIFIED BY 123456; FLUSH PRIVILEGES;参数说明-u root指定用户IDENTIFIED BY后面是你要设的新密码FLUSH PRIVILEGES刷新权限表让密码立即生效。设好密码后再用mysql -u root -p123456登录测试一遍能进Welcome to the MySQL monitor就说明数据库这一关过了。3.3 IDEA 导入项目先把 war 包或文件夹结构对号入座拿到这套资源的实际形态可能是已编译的文件夹包含WEB-INF目录或者一个 war 包。如果是 war 包可以直接把 war 放到 Tomcat 的webapps目录下启动 Tomcat 后它会自动解压。如果是一堆散落的 .class 文件我在 IDEA 里的导入习惯是新建一个空 JavaWeb 工程然后手动把WEB-INF/classes下的包结构复制到工程的 src 目录把web.xml和 JSP 页面放在web目录下再引入WEB-INF/lib里的依赖 jar 包。具体路径对应关系如下表所示资源文件放在 IDEA 工程里的位置.class 字节码src 目录下的包结构JSP/HTML/CSS/JSweb 目录下web.xmlweb/WEB-INF/web.xmllib 下的 jar 包Project Structure → Libraries 添加有一步容易漏MyBatis 的 mapper XML 文件比如UserMapper.xml通常放在包目录下但 IDEA 默认编译时不会把 xml 文件当资源带去 classes 目录你要在 pom 或 build 配置里声明资源目录。如果你是纯手工导入非 Maven直接确认 xml 文件物理存在于 classes 对应目录否则启动时会报Invalid bound statement (not found)。IDEA 中配置本地 Tomcat是到 Run/Debug Configurations新增 Tomcat Server → Local在 Application server 里选到你 Tomcat 首页指定的 Tomcat 8.5 路径然后 Deployment 里添加 Artifact 或 External SourceApplication context 改成/crm这样访问路径就是http://localhost:8080/crm/。Tomcat 启动出现中文乱码是常见问题Server 日志输出乱码通常是 Tomcat 的 logging 文件编码问题页面显示乱码则是 JSP 的page contentTypetext/html;charsetUTF-8%没写或写错后面在避坑节展开。3.4 前端依赖Layui、JQuery 的引入方式和加载顺序项目前端用的是 Layui、HTML、CSS、JS、JQuery。Layui 是一套模块化前端 UI 框架表格、表单、分页、弹窗都封装好了对后端开发来说最友好的一点是不需要会复杂的 JS 构建环境。你导入项目后前端加载顺序有讲究先引入 jQuery再引 Layui 核心 JS最后是页面自己的脚本CSS 则先 Layui CSS再全局面板样式。页面头部通常长这样link relstylesheet href${pageContext.request.contextPath}/lib/layui/css/layui.css script src${pageContext.request.contextPath}/lib/jquery/jquery.min.js/script script src${pageContext.request.contextPath}/lib/layui/layui.js/script${pageContext.request.contextPath}是 JSP EL 表达式动态取到当前工程访问路径防止你改项目名后所有静态资源 404这一条请记住很多 JSP 项目换了应用名后页面没样式就是这个原因。Layui 的表格渲染通常用table.render数据源指向你后台 Servlet 的 JSON 接口这也是这套系统「数据统计」模块最常见的实现方式。你在把.class反编译回源码后找出这些 JS 里url:字段配的地址就能快速对上前端页面是调的哪个 Controller。4. 常见问题与避坑数据库、Tomcat、字符集和字节码的五处翻车现场4.1 MySQL 服务启动即闪退日志不看改一百遍 my.ini 都没用现象双击mysqld或执行net start MySQL57后服务秒退Windows 事件查看器里只留一句「服务无法启动」。很多人这时候就反复改 port、改 basedir越改越乱。原因90% 是初始化没做或者my.ini的路径写错。解压版 MySQL 必须先把datadir目录初始化出来没初始化就启动mysqld 会在日志里明确写Cant find error-message file或Table mysql.plugin doesnt exist。另一个高频原因是端口被占用netstat -ano | findstr 3306能看到别的进程占着 3306。解决第一步删掉 data 目录重新初始化mysqld --initialize-insecure。第二步看日志在my.ini里加一行log-errorD:/mysql-5.7.44-winx64/mysql.log重启服务后打开这个日志文件里面每一行都是原因。端口冲突就把port3306改成port3307同时连接时用-P 3307指定端口。从那以后我每装一次 MySQL都强制先看日志再动手改配置纯靠猜一点用没有。4.2 导入 SQL 脚本报错Incorrect string value 和 utf8 的坑现象用 Navicat 或命令行导入项目自带的 .sql 文件时报Incorrect string value: \xE6\x9F\x90 for column xxx数据里所有中文都变成问号或直接中断导入。原因数据库或表用的是utf8编码而不是utf8mb4。MySQL 的utf8是 3 字节编码存不了中文生僻字、Emoji 以及部分字符报错信息里那个\xE6\x9F\x90就是中文字的 UTF-8 字节序列库表装不下。解决建库时统一用utf8mb4已经在跑的项目可以手动改库表编码ALTER DATABASE crm CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; ALTER TABLE t_customer CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;CONVERT TO会同时改表和所有字符串列的字符集是省事的做法。导入时命令行再追加--default-character-setutf8mb4Navicat 里则在连接属性的编码里选 65001UTF-8。连接 URL 也要带上编码参数JSP 项目里通常是jdbc:mysql://localhost:3306/crm?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai这三个核心参数串含义分别是useUnicodetrue告诉驱动使用 UnicodecharacterEncodingutf8指定应用端编码useSSLfalse关闭 SSL 告警MySQL 5.7 自带 SSL 证书不关的话控制台会刷一堆 SSL 警告但一般不影响跑。serverTimezone在中国环境必须配否则高版本驱动报时区错误。4.3 HTTP 404web.xml 映射路径和项目访问根路径对不上现象启动 Tomcat 没报错但浏览器访问http://localhost:8080/crm/login.jsp直接 404或者页面能打开但点登录后跳转 404。原因两类一是工程的应用上下文Application context不是/crm部署到 Tomcat 后实际访问路径变成了http://localhost:8080/项目名_war_exploded/但是你的跳转地址写死成/crm/xxx.jsp肯定 404二是 servlet 映射配置错误比如你写的url-pattern是/login但表单提交地址是login.do必然打不到控制器。解决打开web.xml检查所有servlet-mapping里的url-pattern必须和前端表单/超链接的请求地址一一对应。拿登录功能举例servlet servlet-nameUserController/servlet-name servlet-classcom.company.controller.UserController/servlet-class /servlet servlet-mapping servlet-nameUserController/servlet-name url-pattern/user/url-pattern /servlet-mapping这里url-pattern/user/url-pattern表示所有http://localhost:8080/crm/user的请求都会被 UserController 接住注意斜杠前不需要写应用名。表单请求的地址如果是user?actionlogin那么action参数也会被 Servlet 的doGet/doPost里用request.getParameter(action)分发。IDEA 里检查 Application context 的方式是 Run 配置的 Deployment 页签改成/crm改完重启 Tomcat。4.4 JSP 页面没样式没图片不只是路径问题是静态资源被拦截了现象页面能打开但是 Layui 的按钮、表格、弹窗全是裸的 HTML 样式控制台报一堆Failed to load resource: 404指向layui.css或layui.js。原因大多数情况是 JSP 里写了相对路径比如hreflayui/css/layui.css当前 URL 层级一变相对路径就失效。另一个隐蔽原因是web.xml里配置了/*的拦截器把静态资源也拦了Servlet 处理不了 .css/.js 请求返回 404。解决统一用 EL 表达式拼根路径模板开头写死% String basePath request.getScheme() :// request.getServerName() : request.getServerPort() request.getContextPath() /; % link relstylesheet href%basePath%lib/layui/css/layui.css script src%basePath%lib/jquery/jquery.min.js/script这样不管你在内层目录还是外层目录路径永远从应用根开始算。如果确认路径没问题但资源还是被拦去web.xml里给静态扩展名加一段放行配置或者把 filter 的url-pattern从/*改成指定 servlet 的路径。Layui 的资源目录在解压包里一般就叫layui里面分css、js、fonts等子目录建议保持原结构别动只改引用路径。4.5 反编译 .class 出来的代码编译不过JDK 版本和依赖缺失现象从CFR反编译出来的.java放进 IDEA 后一片红色报错比如Cannot resolve symbol XXUtil或者Unsupported class file major version。原因两件事。第一是反编译出来的源码可能引用了原工程的内部工具类你没有把全部 .class 都反编译完或者 lib 目录下的第三方 jar 没引入第二是编译字节码用的 JDK 版本比你的高major version对应关系是 52JDK855JDK11你的环境是 JDK8 却装了 JDK17 编译的字节码肯定不认。解决先用命令查一下字节码版本javap -verbose com.company.controller.UserController.class | findstr major输出major version: 52表示 JDK8如果显示 55 以上要么你升级本机 JDK要么找原项目用低版本重新编译。依赖缺失的问题我一般会对项目里的类名逐个反编译把import里出现的类全部找出来缺失的工具类单独补上或从 lib 拷贝 jar。反编译代码仅作参考实际修复时以行为逻辑为准不要指望还原出 100% 原始代码局部报错就手工修局部——这一步做完你对 Servlet 的生命周期理解会深一截。5. 把反编译源码接回工程补全 Mapper 与 web.xml 后一次跑通这一章是整条流水线的收口。你反编译出了 Controller 的 .java也建好了库表现在要做的就是把散落的零件组装回一个 IDEA 能编译的工程。我先说组装顺序再讲两个最容易断头的地方怎么接。5.1 反编译后的 Controller、Service、DAO怎么和 Mapper XML 对上先把WEB-INF/classes下的所有 .class 按包路径批量反编译建议用 CFR 对整个 classes 目录跑一遍java -jar cfr.jar --outputdir ./src ./WEB-INF/classes--outputdir指定输出目录后面跟的是待反编译的字节码目录这条命令会把所有 .class 按原包结构输出成 .java比一个个文件反编译省事得多。反编译出来的文件不要直接覆盖整个 src而是按模块对比着看主要看 DAO 接口里有哪些方法再去MyBatis的 mapper XML 目录找对应的select、insert、update标签确认namespace全限定名和 DAO 接口全限定名一致。MyBatis 最常翻车的点就在这namespacecom.company.dao.UserMapper写错或者select idselectByUsername的 id 和接口方法名对不上启动时会报Invalid bound statement (not added to mapper)这个报错几乎是 MyBatis 手工工程的身份证看到它先查这两处。5.2 手工工程没有 Mavensrc 目录、web 目录、lib 目录三件事缺一不可IDEA 里新建一个 JavaWeb 工程不引入 Maven 时是纯手工结构。你需要把 idea 的项目结构面板打开确认三件事第一反编译出来的 .java 所在目录标记为 Sources Root这样代码还能继续编译第二JSP 和静态资源目录web 目录标记为 Web Resources Directory否则 Tomcat 部署时根本看不到页面文件第三WEB-INF/lib下的 jar 包全部加入 Libraries包括servlet-api.jarTomcat 自带的编译时需要、mybatis.jar、mysql-connector-java.jar、jstl.jar等。如果漏掉 servlet-api所有HttpServletRequest、HttpServletResponse相关的类都会飘红如果漏掉 mysql-connector运行时报ClassNotFoundException: com.mysql.jdbc.Driver。5.3 最后验证方法从启动到增删改查跑一圈再抓一个 debug全部接好之后启动 Tomcat用admin/123456以你的数据库实际记录为准登录进入系统后按这样一条路径验证新增一个客户 → 给客户新增一个联系人 → 从线索模块创建一个线索并转成客户 → 在交易模块建一笔订单 → 到数据统计页确认数字更新。能完整走通一遍说明 Servlet 路由、MyBatis 映射、数据库 DML、JSP 回显全部正常。如果中途哪步失败优先看 IDEA 控制台的 Tomcat 日志重点抓Caused by后面的第一行原因那才是真正的根因。验证通过后顺手把连接池参数和 SQL 日志打开log4j里设置logger namecom.company.dao为 DEBUG 级别此时控制台会打印 MyBatis 执行的每一条 SQL你能实时看到参数绑定情况排查问题时比猜快了不知多少倍。这套拆完再跑完的过程给我最大的体会是不要只盯着下载包里是不是源码先看自己的 JDK 版本和数据库编码再研究它对应的业务流。有了这套项目打底回头看 Spring Boot 整合 MyBatis 其实就是在熟络了这套手工装配之后的效率化封装而已。希望帮到你。本文还有配套的精品资源点击获取