简介基于Java技术的CRM客户关系管理系统毕业设计资料包完整涵盖源码、演示视频、数据库脚本与答辩文档面向需要完成课程设计或毕业设计的计算机专业学生。系统基于MyEclipse开发采用Struts2Hibernate3Spring4经典SSH架构数据库为MySQL包含客户信息、订单、财务、产品、部门岗位、权限等核心业务模块。资料包共13个文件以zip源代码、sql数据库脚本、3段MP4操作演示视频为主体另有答辩PPT、实现文档、运行截图及readme说明压缩包约83.23MB。演示视频覆盖项目配置、启动与主要功能操作可辅助完成环境搭建和界面演示。目前已有2175人学习下载适合作为CRM系统开发学习和毕业设计参考。1. 用 Java 自己跑一套 CRM 源码值不值先看这几件事拿到一套基于 Java 语言编写的 CRM 客户关系管理系统源码包里面往往附带教学视频、论坛入口和数据库脚本。这类交付在 java 课程设计案例源码里出现频率极高因为客户管理业务的盘面足够典型有角色权限、有数据流转、有统计报表正好覆盖 java 基础到数据库增删改查的整条链路。但多数人第一反应是这玩意儿能跑起来吗还是视频里演示流畅、自己一启动就报错我见过的翻车现场十有八九不是代码问题而是卡在数据库脚本怎么导、数据源怎么改、启动入口在哪个类这三件事。这三件事点破之后剩下就是业务改造的体力活。本文按部署和改造两条线展开把这套系统的骨架、操作步骤和踩坑记录一次讲完。适合做课程设计的学生、想把客户信息搬进系统的小团队以及准备面试前想补一遍真实权限模型的新人。2. 拆 Java CRM 的骨架模块分层、权限模型与数据库设计2.1 四个核心业务模块线索、客户、跟进、商机无论源码包的界面长什么样CRM 的业务流程逃不出这条漏斗线索进来转成客户记录跟进最后成单。对应的数据库里至少要有一张线索表、一张客户表、一张跟进记录表、一张商机表。只要你看懂了这四张表这套系统的业务范围也就框住了。线索表保存还没确认的潜在客户可能来自表单留资、展会名片或者网页留言常见字段是姓名、电话、来源渠道公司信息往往是空的。客户表是主表字段明显更厚重客户名称、联系人、电话、邮箱、所属销售、客户等级、来源渠道。跟进记录表每次电话或拜访追加一条字段包含客户 ID、跟进方式、内容摘要、下次联系时间。商机表记录可能成交的机会有预计金额、预计成交日期、当前阶段。如果你打开数据库脚本时发现四张表都在说明这套源码的业务建模是完整的如果所有客户的跟进记录全塞在客户表里那后面做统计报表时会很难写。我在改造旧系统时遇到最多的就是第二种情况那时唯一的选择是拆表而不是硬着头皮继续加列。判断一套 CRM 源码值不值得深入先看表结构就是一种比较讨巧的办法。另外模块之间是单向数据流线索可以合并进客户客户又以 customer_id 回挂跟进和商机。把业务流画在纸上对照代码你会发现 Controller 里的接口列表跟这张图几乎是重合的这对新手理解源码结构很有帮助。2.2 Java 后端的三层Controller、Service、MapperJava 写的 CRM 源码大多按 Spring MVC MyBatis 的老三样组织代码。Controller 层负责接收参数、调用服务、包装返回结果Service 层承载业务规则比如重复客户校验、跟进状态流转、操作日志记录Mapper 层就是纯数据库增删改查SQL 写在 XML 或者注解里。新手看这类代码有个习惯打开 Controller 就往下翻想一口气看完整个请求路径。我建议反过来先看调用链请求打到 CustomerController 的 list 方法里面调 customerService.pageQuery(request)进入 CustomerServiceImpl最后落到 CustomerMapper.selectCustomerPage。每一层只做一件事这就是分层的好处。如果你发现某个 Controller 里直接写了 JdbcTemplate 甚至裸 JDBC那这套代码的质量就要打问号二次开发前最好先把逻辑拆回 Service 层。三层结构也是面试时可以聊的素材。java 面试题里常问的 Spring 事务失效、MyBatis 一级缓存和二级缓存的区别都是在分层前提下的实际问题。有真实代码对照比背八股文要可靠得多。你可以试着在源码里找一处事务注解看看它加在 Service 的哪个方法上再想想如果内部方法之间互相调用事务会不会失效这就是经典的面试考点落到了实处。2.3 数据库设计主表、流水表与字典表数据库脚本是整个源码包里最重要的交付物重要程度甚至超过源码本身。导完数据后先别急着登录系统把表结构浏览一遍。我有个快速归类方法把 sys_ 开头的表和业务表分开看。sys_user、sys_role、sys_menu 三张表决定谁能看到什么菜单customer、customer_follow_up 这几张表决定业务数据怎么流转。主表是指每一条记录代表一个实体的表比如客户表流水表是只增不改的记录比如跟进记录表字典表是给下拉框供数据的比如客户来源字典。打开数据库脚本时给每个表打上这三类标签之一。能完成这一步你对系统的理解就已经超过只看视频跟练的人。外键在这类系统中大多是逻辑外键不建立物理约束。原因很实际物理外键在删除客户时会被跟进记录拦住CRM 里删除客户往往希望把名下跟进记录一起清理掉物理约束反而碍事。逻辑外键靠 MyBatis 的 resultMap 做关联查询。用 DataGrip 画 ER 图时看到表之间没有连线不代表设计错误只是约束被放在了应用层。这个常识能省下你有一次去研究“为什么外键没生效”的功夫。字典表方面通常有一张 sys_dict 表存客户来源、客户等级、跟进方式页面下拉框就是从它里面取配置的。以后想加一个“抖音渠道”选项直接在 sys_dict 里加一条记录不用改 Java 代码。这是最高性价比的改动方式。2.4 权限模型RBAC 的落地与按钮级控制权限模型是一套 Java CRM 最重要的后台设计。sys_user 关联角色角色关联菜单菜单下挂按钮这是经典的 RBAC基于角色的访问控制结构。平时改权限经常不用碰 Java 代码只改 sys_menu 表里的数据就能生效。最容易踩空的地方是按钮权限。这类系统会把“新增客户”“删除订单”当作 sys_menu 表里的一条菜单记录用 menu_type 字段区分目录、菜单、按钮。页面显示正常但按钮点了没有反应先别怀疑前端去查 sys_role_menu 里有没有这条按钮级别的关联数据。我调试过的大部分权限问题其实都不是代码 bug是关联数据漏配了。角色的数据范围也值得留意。admin 角色通常查全部数据普通销售角色只能看自己名下的客户。这种过滤往往不写在 SQL 里而是在 Service 层拼了一个 owner_user_id 条件。后面如果需求改成“经理能看到整个部门的数据”就要先找到这个过滤逻辑在哪个方法里再按部门维度调整。套着 CRM 讲给客户听比干巴巴讲 RBAC 概念好理解得多。3. 把 Java CRM 源码跑起来本机部署的全过程3.1 环境准备JDK 版本、Maven 和 MySQL部署之前先确认环境。这类源码最挑的是 JDK 版本和 MySQL 版本。老一点的基于 JDK 1.8新一点的基于 JDK 11 或 17版本不匹配会先翻车在编译期。先打开命令行确认三个版本号java -version mvn -version mysql --version三个命令的输出要对照源码的依赖来看。如果电脑装的 JDK 是 17而 pom.xml 里 maven-compiler-plugin 的 source/target 是 1.8编译时会报错或者产生奇怪的类版本问题。MySQL 5.7 和 8.x 的驱动类名不一样这直接影响下一步的数据源配置。还有一个容易被忽略的是 JAVA_HOME 环境变量IDE 里能启动但命令行跑 Maven 报错通常就是它没配好。echo $JAVA_HOME在 Windows 上配环境变量是系统设置里的“高级系统设置”在 macOS 上可能要手动 export但这属于一次性工作。环境配好了后面基本不会再动它。3.2 还原数据库导入脚本并验证表数量源码包的数据库目录下通常有一个 .sql 文件。导入之前先建一个空库指定字符集这一步对中文很重要mysql -uroot -p -e create database crm charset utf8mb4; mysql -uroot -p crm crm.sql第一行建库时指定 utf8mb4是避免后面页面出现中文乱码的关键。第二行把脚本导入。如果脚本内部自带 create database 和 use 语句建库命令可以省掉。导入过程报错时常见原因是脚本里用了高版本 MySQL 的语法而本地版本太低这时要优先考虑升级本地 MySQL。导入完成后验证一下表是否齐全mysql -uroot -p -e use crm; show tables;老系统常见的表规模在 10 到 20 张之间。如果表数量明显偏少很可能是导入中途出错被跳过需要检查报错信息后重新导入不要带着残缺的表结构继续往下走。3.3 修改数据源配置连接池参数按需调源码包默认的数据库配置几乎不可能直接连上你的环境。找到 src/main/resources 目录下的 application.properties 或 jdbc.properties这是连接数据库的唯一入口spring.datasource.urljdbc:mysql://127.0.0.1:3306/crm?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai spring.datasource.usernameroot spring.datasource.password你的密码 spring.datasource.driver-class-namecom.mysql.cj.jdbc.Driver连接串末尾的 serverTimezoneAsia/Shanghai 必须保留MySQL 8 的驱动拿不到时区会直接报错这是连接失败最常见的原因。characterEncodingutf8 要和建库时的 charset 保持一致否则中文会以问号形式写入。如果源码里写的是老的驱动类名 com.mysql.jdbc.Driver就先统一升级成 com.mysql.cj.jdbc.Driver然后在 pom.xml 里确认 mysql-connector-java 的版本在 8.x。连接池参数我一般按最小可用来调而不是照抄网上配置spring.datasource.hikari.maximum-pool-size10 spring.datasource.hikari.minimum-idle2 spring.datasource.hikari.idle-timeout600000本地演示环境最大连接数 10 已经足够调到 20 以上除了让数据库白白多开连接没有任何好处。生产环境再根据并发量另行核算。3.4 编译、启动与自测三步走配置改完后建议先命令打包一次把编译错误提前暴露出来mvn clean package -DskipTests看到 BUILD SUCCESS 再启动。如果只在 IDE 里运行 main 类也可以跳过打包这个步骤直接用 IDE 的 Run 按钮。打包方式启动时java -jar target/crm-system.jar --server.port8080启动日志出现 Started 开头的文字后访问 http://localhost:8080/。如果端口被占用可以换一个端口启动。登录后不要急着看报表先做三条自测路径确认菜单能正常显示新增一条测试客户给这条客户补一条跟进记录。这三步都跑通这套源码在你的机器上才算真正活了。我见过不少人漏了最后一步结果真正录数据时卡在客户详情页的转圈上。4. 把 CRM 改成你的业务字段扩展与查询定制的标准做法4.1 给客户表加字段从数据库到页面的全链路本地跑通之后最常做的事是加业务字段。比如客户表要补一个“客户来源渠道”从数据库开始ALTER TABLE customer ADD COLUMN channel varchar(50) DEFAULT manual COMMENT 客户渠道manual/ads/partner;COMMENT 必须写不然半年后没人知道这个字段是干什么的。MySQL 加完列之后页面上要生效还需要动三处代码实体类加对应属性Mapper 的 insert 语句加这个列查询结果的映射确认包含它。拿实体类来说找到 Customer.java加上private String channel; public String getChannel() { return channel; } public void setChannel(String channel) { this.channel channel; }如果用 MyBatis-Plus简单 CRUD 可以省掉 XML 配置修改如果项目的 Mapper 是手写 XML就必须打开 CustomerMapper.xml检查 insert 语句里有没有 channel 对应的一对标签。漏掉的话新增客户时这个字段会静默丢失页面不报错但数据库里是 NULL这种隐性 bug 最浪费排查时间。数据库加字段之后表单页面上的输入框和列表页的查询条件也需要同步加。这一步通常由前端页面完成但源码包里如果有权限控制还需要检查新增字段是否要作为客户可见信息开放给普通销售角色。4.2 修改列表查询加入自定义过滤条件CRM 改业务时有一个高频场景列表页要多一个筛选条件。比如客户列表要按“状态”过滤。改法先从 Service 层入手让查询条件对象携带 status 字段public PageResultCustomer pageCustomer(CustomerQuery query) { // 校验逻辑status 允许为空但传了就必须是合法值 if (query.getStatus() ! null !isValidStatus(query.getStatus())) { throw new BusinessException(非法的客户状态); } PageHelper.startPage(query.getPageNum(), query.getPageSize()); ListCustomer list customerMapper.selectCustomerByCondition(query); return new PageResult(list); }然后在 CustomerMapper.xml 里加对应的查询条件select idselectCustomerByCondition resultTypecom.example.crm.entity.Customer select id, customer_name, channel, status, owner_user_id from customer where if teststatus ! null and status ! and status #{status} /if /where /select这里有两个常见翻车点。第一where 标签里忘记加 if 判断导致没传参时 SQL 变成 select ... where and直接语法错误。第二字符类型字段的判空条件写成 status ! null 就够数字类型还要考虑 0 值是否合法。MyBatis 的 if 标签本身思想很简单但漏了判空在页面上呈现的却是整个列表加载失败很容易让人误判成前端问题。4.3 权限调整让两种角色看到不同的菜单新需求来了销售角色看不到报表菜单经理角色可以看到。这类改动多数在数据库层面直接完成delete from sys_role_menu where role_id (select id from sys_role where role_code SALE) and menu_id (select id from sys_menu where perms report:view);执行之前先备份一下这条关联记录删除操作不可逆后悔药要先备好。改完后当前登录用户需要退出重新登录权限是在登录时加载进 Session 的不重新登录不会生效。如果系统里用了 Redis 缓存权限还要考虑清缓存或者等缓存过期。比菜单权限更常见的需求是数据权限比如“销售只能看自己名下客户”。这类改动要找到 Service 层里过滤数据的那一行通常是给查询条件注入当前用户名下的 user_id。不要一上来就写 MyBatis 拦截器那个方案虽然通用但负责当前项目没有需求排查问题也困难。先在 Service 层把过滤条件加上稳定之后再考虑抽象成公共能力。4.4 视频与论坛的正确姿势不是看完是拆完源码包附带的视频最佳用法不是从第一集拖到最后一集而是三遍法。第一遍只看到部署完成跟着跑通为止。第二遍跳到自己要改的功能点比如“添加客户”那十来分钟留意它把参数从页面传到数据库的过程。第三遍关掉视频自己独立做一遍。论坛的用法也带目的性有报错信息时先搜关键词大部分问题在论坛早有讨论。发帖求助时一定要附三样东西JDK 和 MySQL 版本、异常堆栈前五行、你改过哪些配置。没有这三样对方很难隔空判断。论坛最有价值的不是你问的哪个问题而是别人沉淀下来的边缘场景比如 MySQL 8 驱动不兼容、Maven 依赖冲突这类靠文档里往往看不到的信息。5. 避坑与排查Java CRM 从源码到稳定运行的常见问题5.1 登录进去全是中文乱码现象登录后菜单栏、客户名称全部显示成问号。原因建库时没有指定字符集或者连接串里漏了 characterEncodingutf8。数据库默认字符集如果是 latin1中文写入时就被转成问号了。解决把库和表统一转成 utf8mb4alter database crm character set utf8mb4 collate utf8mb4_unicode_ci; alter table customer convert to character set utf8mb4;改完以后要重启应用。要注意的是这个操作只对后续写入生效已经存成问号的数据恢复不回来所以建库时把字符集定对才是真正的后悔药方案。5.2 MySQL 版本不一致导致驱动类报错现象应用启动时报 ClassNotFoundException: com.mysql.jdbc.Driver或者连接时直接 Communications link failure。原因源码最初基于 MySQL 5.x 开发配的是旧驱动类名。本地装的是 MySQL 8.x新驱动的类名改成了 com.mysql.cj.jdbc.Driver。解决统一驱动类和依赖版本。pom.xml 里把 mysql-connector-java 锁定到 8.x配置文件的 driver-class-name 改成新类名。改完还要检查项目里有没有其他依赖间接引入了老版本驱动方式是在仓库里全局搜 mysql-connector出现多条时以 Maven 的依赖树为准。混用新旧驱动最容易出这类奇葩问题因为 classpath 里同时存在两个类报错信息却只指向其中一个。5.3 启动成功但访问 404现象控制台显示 Started Application in x seconds但浏览器访问 localhost:8080 返回 404。原因项目配置了 context-path访问路径在前要加一层前缀很多人没注意到。搜索 application.properties 里的 context-path 或 contextPath。解决如果配置是 server.servlet.context-path/crm那访问地址应该是 http://localhost:8080/crm/。另一个可能原因是启动时端口没变化但本机 8080 已经被另一个服务占用。用这个命令确认lsof -i:8080看到占用进程后先确认是不是上一次启动的 java 程序是的话杀掉再重启不要盲目换端口否则前后端联调时的地址都要跟着变。5.4 连接池配置过小导致查询超时现象页面一打开就报 Connection pool is full 或 wait connection timeout。原因连接池最大连接数配置太小或者出现连接泄漏。老项目用 DBCP 时默认 maxTotal 只有 5某个慢查询一卡整池连接就被占满了。解决先把连接池调到一个合理值再排查泄漏spring.datasource.dbcp2.max-total10 spring.datasource.dbcp2.max-wait-millis10000如果并发不高但连接还是被占满就要检查代码里有没有手动 getConnection() 后没有 close 的泄漏。Spring 管理的连接由框架负责返回但老项目里偶尔会有人手写 JDBC这种代码在异常分支最容易漏掉 close。排查时看日志里是不是每次请求后活跃连接数只增不减如果是把业务代码里的 Connection 关闭逻辑补齐比单纯调大连接池更治本。5.5 管理员登录后客户列表是空的现象登录正常菜单正常但客户列表页没有任何数据切换账号也一样。原因列表查询带了 owner_user_id 过滤条件管理员账号在业务数据表里没有匹配的归属记录。有些源码的 admin 是超级管理员绕过过滤另一些则一视同仁导致 admin 查不到任何数据。解决先查归属关系select id, username from sys_user; select owner_user_id, count(*) from customer group by owner_user_id;然后确认当前登录用户的 id 是否出现在 customer.owner_user_id 里。如果没有要么把测试数据归属到 admin 名下要么调整 Service 层的过滤逻辑让管理员跳过这个条件。这个问题不要在浏览器里反复刷新排查直接去 Service 层找过滤逻辑写在哪一行三分钟就能定位。6. 让 CRM 处于受控状态日志验证与连接监控系统跑通、改造完下一步是让运行状态对你透明。我的第一个动作是打开 MyBatis 的 SQL 日志让每一条真实执行的 SQL 都露出来。logging: level: com.example.crm.mapper: debug在 Spring Boot 项目里这样配置以后点击“客户列表”日志里就会打印对应的 select 语句。对比页面传入的查询参数和你预期的 Where 条件能快速确认过滤逻辑有没有生效。这一步对排查“数据不显示”或“查询结果超出预期”的问题特别有效。第二个常做的验证是用简单的接口测试来确认核心链路。以新增客户为例请求 POST 到 /api/customer传入 JSON 数据看返回结果里是否有新记录的 ID。再把该 ID 放到查询接口里确认字段值完整。这套验证做完等于给核心业务流程上了保险。数据库连接状态也要心里有数。HikariCP 自带连接池指标生产机还可以通过监控工具观察活跃连接数。如果活跃连接数持续处于高位同时数据库慢查询日志同步上涨优先考虑加索引而不是无脑调大连接池。我曾经遇到过一次客户列表从第二页开始加载很慢最后定位到 status 字段没有索引全表扫了十几万行才过滤出几十条结果。给条件字段补上索引之后查询时间从两秒降到了几十毫秒。改关键业务 SQL 之前的快照备份也是我固定执行的动作。用 mysqldump 导出当前库万一改造出问题可以直接回滚mysqldump -uroot -p crm crm_backup_before_change.sql这套源码从跑通到改造完成我最大的一个教训是遇到问题时先确认日志内容再去看代码逻辑而不是凭直觉改配置。MySQL 连不上先看驱动版本列表空先查归属过滤乱码先看字符集80% 的问题都有非常标准的排查路径。希望帮到你。本文还有配套的精品资源点击获取