拓冰网站定制 
简介这是一套面向中小企业与二次开发者的旗舰版客户管理系统源码非网上免费版无加密、无域名限制可直接导入数据库安装并自由修改字段与业务逻辑。系统覆盖线索、客户、商机、合同、财务、销售、采购、库存、产品、任务、日程、知识、日志、站内信、营销等模块支持限时限额领取线索、客户高级筛选、自定义字段、审批流程、进销存与报价单转合同等完整业务闭环并新增合同审核自动生成应收款、出库单及回款计划提醒等能力。压缩包共1905个文件以519个php、383个html、185个js、68个css及大量png、gif图片资源为主另含sql数据库脚本与config、functions等配置目录整体约11.92MB。已有384人学习下载适合希望低成本搭建客户管理平台、研究CRM业务流与进行个性化二开的开发者参考。1. 拿到一套 CRM 旗舰版源码先别急着改代码很多做企业信息化的朋友拿到「某CRM旗舰版功能齐全客户管理系统源码.zip」这类压缩包第一反应是解压、找入口文件、把数据库一挂然后打开浏览器看首页能不能跑起来。这个顺序本身没错但真正决定这套源码能不能落地的不是首页能不能打开而是客户、商机、合同、跟进记录这几张核心表的关系有没有理清。CRM 系统跟博客、商城不一样它的价值全在数据流转上一条线索怎么变成客户客户怎么挂上商机商机怎么推进到合同合同回款怎么回写到客户视图。这套链路只要断一环功能再齐全也只是个空壳。这篇文章面向三类人一是手里已经拿到这套源码、想二次开发或私有化部署的开发者二是想拿它做课程设计或练手项目、需要快速理解架构的学生三是评估要不要基于它做定制交付的技术负责人。我会按「先看懂数据模型 → 再跑通部署 → 再改一个真实需求 → 最后避坑」的顺序讲中间给到能直接抄的命令和配置。源码类项目最怕的就是玄学问题比如本地能跑服务器报错、定时任务不执行、导出乱码这些我都会拆开说清楚。2. 拆开压缩包先看什么目录结构与技术栈判断2.1 从文件后缀和目录名反推技术栈解压之后不要急着打开 IDE先用命令行把目录树扫一遍重点看配置文件和后缀分布。常见的 CRM 源码无非几种组合PHP 系ThinkPHP / Laravel、Java 系Spring Boot MyBatis、Python 系Django / Flask。判断方法很直接看根目录有没有pom.xml、composer.json、requirements.txt、package.json这几个文件。# 解压后进入目录先看一级结构 unzip 某CRM旗舰版功能齐全客户管理系统源码.zip -d crm-src cd crm-src ls -la # 统计各语言文件数量快速判断主技术栈 find . -type f -name *.php | wc -l find . -type f -name *.java | wc -l find . -type f -name *.py | wc -l find . -type f -name *.vue | wc -l # 找配置文件这是判断框架最准的线索 find . -maxdepth 3 -name pom.xml -o -name composer.json -o -name requirements.txt -o -name application.yml -o -name .env*这段命令的逻辑是先看整体再按后缀计数最后定位配置文件。参数上-maxdepth 3是为了避免在node_modules或vendor里翻太久。如果*.php数量几百上千基本就是 PHP 系如果*.java多且根目录有pom.xml那就是 Spring Boot 系。这一步的意义在于不同技术栈的部署方式和二次开发入口完全不同选错方向后面全是白费功夫。2.2 数据库脚本是理解业务的地图CRM 源码里最值钱的文件不是控制器而是那个.sql文件。它定义了客户表、联系人表、商机表、合同表、回款表、跟进记录表之间的外键和索引。我一般会先把 SQL 导入一个空库然后用工具生成 ER 图或者直接查information_schema看表关系。-- 查看所有表及注释快速定位核心业务表 SELECT TABLE_NAME, TABLE_COMMENT FROM information_schema.TABLES WHERE TABLE_SCHEMA crm_db ORDER BY TABLE_NAME; -- 查看客户表结构重点看外键和索引 SHOW CREATE TABLE crm_customer; -- 查商机表与客户表的关联字段 SELECT COLUMN_NAME, REFERENCED_TABLE_NAME, REFERENCED_COLUMN_NAME FROM information_schema.KEY_COLUMN_USAGE WHERE TABLE_SCHEMA crm_db AND REFERENCED_TABLE_NAME IS NOT NULL;第一条查表注释能快速知道每张表干什么第二条看客户表的完整定义重点确认owner_id负责人、create_time、status这些字段的类型和索引第三条查外键关系理清商机、合同是怎么挂到客户上的。参数上把crm_db换成你实际导入的库名即可。如果源码没有外键约束很多 CRM 为了性能故意不加那就得靠字段命名规律去猜比如customer_id、opportunity_id这种。提示如果 SQL 文件里用了utf8mb4但你的 MySQL 版本低于 5.5导入会报错先确认版本再动手。2.3 配置文件里的三个关键项不管什么技术栈配置文件里一定有三个东西要改数据库连接、缓存/会话存储、文件上传路径。以常见的 Spring Boot 为例application.yml里重点看这几段。spring: datasource: url: jdbc:mysql://127.0.0.1:3306/crm_db?useUnicodetruecharacterEncodingutf8mb4 username: root password: your_password redis: host: 127.0.0.1 port: 6379 database: 0 servlet: multipart: max-file-size: 50MB max-request-size: 100MB crm: upload: path: /data/crm/upload/ url-prefix: /static/upload/datasource.url里的characterEncodingutf8mb4必须写否则客户姓名里的生僻字会变问号。redis如果源码里用来存 session 或验证码不配的话登录会一直失败。upload.path是附件和导入文件的落盘位置这个目录必须提前建好并给写权限否则上传客户 Excel 时会报 500。我见过太多人卡在「登录没反应」最后发现是 Redis 没启动。3. 本地跑通的最小路径从建库到登录后台3.1 建库导数据与依赖安装先把数据库准备好再装依赖最后启动。顺序反了会出现「表不存在」或「依赖冲突」的报错排查起来很烦。# 1. 创建数据库字符集必须 utf8mb4 mysql -uroot -p -e CREATE DATABASE crm_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; # 2. 导入 SQL 脚本 mysql -uroot -p crm_db ./sql/crm_init.sql # 3. 如果是 Java Maven 项目装依赖并打包 mvn clean package -DskipTests # 4. 如果是 PHP 项目装 Composer 依赖 composer install --no-dev # 5. 启动以 Spring Boot 为例 java -jar target/crm-1.0.0.jar --spring.profiles.activedev-DskipTests是为了跳过测试类很多源码的测试用例依赖外部服务不跳过会卡住。--spring.profiles.activedev指定用开发配置避免连到生产库。PHP 项目的话composer install --no-dev不装开发依赖速度快很多。启动后看日志里有没有Started Application in x seconds有就说明服务起来了。3.2 默认账号与权限表排查后台登录不进去九成是账号密码不对或者权限表没数据。先查用户表。-- 查管理员账号密码通常是 MD5 或 BCrypt SELECT id, username, password, status FROM sys_user WHERE username admin; -- 查角色和权限关联 SELECT u.username, r.role_name, m.permission FROM sys_user u JOIN sys_user_role ur ON u.id ur.user_id JOIN sys_role r ON ur.role_id r.id JOIN sys_role_menu rm ON r.id rm.role_id JOIN sys_menu m ON rm.menu_id m.id WHERE u.username admin;如果password是 32 位大概率是 MD5可以用在线工具或SELECT MD5(123456)验证。如果是$2a$开头那是 BCrypt不能直接改得用代码生成。status字段如果是 0 或 2说明账号被禁用改成 1 再试。权限表没数据的话后台菜单会是空的这时候要么手动插数据要么找源码里的初始化脚本重新跑。3.3 前端资源与接口联调现在很多 CRM 源码是前后端分离的后端跑在 8080前端跑在 3000 或 5173。前端启动前先看package.json里的scripts。# 进入前端目录 cd crm-web # 装依赖国内建议换源 npm install --registryhttps://registry.npmmirror.com # 开发模式启动 npm run dev # 生产打包 npm run build--registry换成国内源是为了避免下载超时。启动后如果页面能打开但接口 404检查vite.config.js或vue.config.js里的proxy配置把/api代理到后端地址。常见坑是代理配了但后端没开跨域浏览器控制台会报 CORS 错误这时候要么后端加CrossOrigin要么前端继续用代理。注意前端打包后的dist目录要放到后端静态资源目录下或者用 Nginx 单独托管否则刷新页面会 404。4. 二次开发实战给客户列表加一个扫码采集入口4.1 需求拆解与表结构扩展「crm管理系统结合扫码采集」是现在很实际的需求销售参加展会客户扫二维码填信息直接进 CRM 线索池。实现路径分三步建一张扫码记录表、写一个公开的表单页面、提交后写入客户表并标记来源。-- 扫码采集记录表 CREATE TABLE crm_scan_record ( id BIGINT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(50) COMMENT 客户姓名, phone VARCHAR(20) COMMENT 手机号, company VARCHAR(100) COMMENT 公司名称, source VARCHAR(50) DEFAULT scan COMMENT 来源, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, status TINYINT DEFAULT 0 COMMENT 0待跟进 1已转化 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;字段设计上phone加普通索引方便去重status用来区分是否已经转成正式客户。source固定为scan后续统计渠道效果时直接GROUP BY source就行。4.2 后端接口与去重逻辑接口要做两件事接收表单、按手机号去重后写入。如果手机号已存在更新记录而不是新增。PostMapping(/api/scan/collect) public Result collect(RequestBody ScanForm form) { // 1. 参数校验 if (StringUtils.isBlank(form.getPhone())) { return Result.fail(手机号不能为空); } // 2. 按手机号查重 Customer exist customerMapper.selectByPhone(form.getPhone()); if (exist ! null) { // 已存在则更新来源和跟进状态 exist.setSource(scan); customerMapper.updateById(exist); return Result.ok(已存在已更新来源); } // 3. 写入客户表 Customer customer new Customer(); customer.setName(form.getName()); customer.setPhone(form.getPhone()); customer.setCompany(form.getCompany()); customer.setSource(scan); customer.setOwnerId(0L); // 待分配 customerMapper.insert(customer); // 4. 记录扫码日志 scanRecordMapper.insert(buildRecord(form)); return Result.ok(提交成功); }selectByPhone走的是手机号索引速度很快。ownerId设为 0 表示待分配后续可以做个定时任务或手动分配给销售。返回结果里区分「已存在」和「新增」前端可以给不同提示。这段代码的关键是去重不然同一个客户扫两次就变成两条线索销售跟进时会打架。4.3 前端表单与二维码生成前端用一个简单的 H5 页面配合二维码工具生成入口。// 提交表单 async function submitForm() { const data { name: document.getElementById(name).value, phone: document.getElementById(phone).value, company: document.getElementById(company).value }; // 简单校验 if (!/^1[3-9]\d{9}$/.test(data.phone)) { alert(手机号格式不对); return; } const res await fetch(/api/scan/collect, { method: POST, headers: { Content-Type: application/json }, body: JSON.stringify(data) }); const result await res.json(); alert(result.msg); }手机号正则^1[3-9]\d{9}$覆盖了国内主流号段。提交用fetch而不是表单直接 post是为了拿到 JSON 结果做提示。二维码那边用任意库把页面 URL 生成图片打印出来就行展会现场贴桌上让客户扫。提示公开接口一定要加频率限制否则会被脚本刷爆。常见做法是用 Redis 记录 IP 提交次数超过阈值直接拒绝。5. 部署与性能避坑那些让你加班到凌晨的细节5.1 定时任务不执行现象、原因、解决现象客户跟进提醒、商机超时预警这些定时任务本地跑得好好的服务器上就是不发。原因多数是时区问题。服务器用 UTC代码里写的是cron 0 0 9 * * ?实际执行时间是北京时间下午 5 点。另一个原因是多实例部署两个节点同时跑任务数据库里出现重复提醒。解决启动参数加-Duser.timezoneAsia/Shanghai或者在配置文件里指定时区。多实例的话引入分布式锁用 Redis 的SETNX或 Quartz 的集群模式保证同一时间只有一个节点执行。5.2 导出 Excel 乱码或超时现象客户列表导出小数据量正常超过一万条就超时或者文件打不开。原因一次性查全量数据放内存JVM 直接 OOM或者用HttpServletResponse输出时没设字符集中文变乱码。解决分页查询每批 5000 条写入 EasyExcel 的ExcelWriter最后统一关闭。响应头设置response.setContentType(application/vnd.ms-excel;charsetutf-8)文件名用URLEncoder.encode处理。数据量特别大的话改成异步导出前端轮询进度导出完给下载链接。5.3 附件上传路径权限与 Nginx 配置现象上传客户合同附件报 500日志里写Permission denied。原因upload.path指向的目录不存在或者运行服务的用户没有写权限。解决mkdir -p /data/crm/upload chown -R www:www /data/crm/upload把目录所有者改成运行服务的用户。Nginx 那边加一段静态资源映射让上传的文件能通过 URL 访问。location /static/upload/ { alias /data/crm/upload/; expires 7d; }alias和root的区别要注意alias是替换匹配路径root是拼接配错了会 404。5.4 数据库连接池耗尽现象系统跑一段时间后所有接口变慢最后报Connection is not available。原因连接池最大连接数设太小或者代码里有地方拿了连接没关。解决HikariCP 的话把maximum-pool-size调到 20 到 50同时开leak-detection-threshold查泄漏。代码里所有Connection、Statement、ResultSet都要在finally里关或者用 try-with-resources。MyBatis 的话检查有没有手写 JDBC 的地方。5.5 缓存与数据库不一致现象改了客户名称列表页还是旧名字刷新几次才变。原因用了 Redis 缓存客户信息更新数据库后没删缓存或者删了但前端还有本地缓存。解决更新逻辑改成「先更新数据库再删除缓存」删除失败就重试。查询时如果缓存没有从数据库读并回写。前端接口加Cache-Control: no-cache头避免浏览器缓存。这个坑很经典血泪经验就是别用「先删缓存再更新数据库」并发下必出脏数据。6. 让这套 CRM 源码真正值钱的三个进阶动作第一件事把客户去重做成可配置规则。默认按手机号去重但有些行业按公司名去重更合理。在配置表里加一个dedup_rule字段支持phone、company、phone_company三种模式代码里用策略模式切换。这样交付给不同客户时不用改代码改配置就行。第二件事给客户列表加一个「最后跟进时间」的冗余字段。CRM 里最常用的查询是「超过 7 天没跟进的客户」如果每次都要 join 跟进记录表再 group by数据量大了会很慢。在客户表加last_follow_time每次新增跟进记录时更新这个字段查询时直接WHERE last_follow_time DATE_SUB(NOW(), INTERVAL 7 DAY)走索引秒出。第三件事把权限控制从菜单级细化到数据级。现在很多 CRM 源码的权限只控制「能不能看客户菜单」但实际业务里销售 A 只能看自己的客户主管能看团队的老板能看全部。实现方式是在客户表加owner_id和dept_id查询时根据当前用户角色拼接WHERE条件。这个改动涉及所有列表接口建议抽一个DataScopeInterceptor统一处理别在每个 Service 里手写。进阶动作改动范围收益风险去重规则可配置配置表 去重逻辑交付灵活规则冲突时需明确优先级最后跟进时间冗余客户表 跟进模块查询快 10 倍数据一致性需事务保证数据级权限所有列表接口符合真实业务拦截器写错会越权这三个动作做完这套源码就从「能跑」变成「能交付」。我自己的习惯是每改一个模块先在测试库跑一遍全量回归重点看客户、商机、合同三个列表的查询结果对不对。源码类项目最怕的就是改 A 崩 B所以改之前先备份数据库改之后用git diff过一遍代码确认没有误删。希望帮到你。本文还有配套的精品资源点击获取 CRM旗舰版源码二次开发实战：从数据模型到部署避坑
简介这是一套面向中小企业与二次开发者的旗舰版客户管理系统源码非网上免费版无加密、无域名限制可直接导入数据库安装并自由修改字段与业务逻辑。系统覆盖线索、客户、商机、合同、财务、销售、采购、库存、产品、任务、日程、知识、日志、站内信、营销等模块支持限时限额领取线索、客户高级筛选、自定义字段、审批流程、进销存与报价单转合同等完整业务闭环并新增合同审核自动生成应收款、出库单及回款计划提醒等能力。压缩包共1905个文件以519个php、383个html、185个js、68个css及大量png、gif图片资源为主另含sql数据库脚本与config、functions等配置目录整体约11.92MB。已有384人学习下载适合希望低成本搭建客户管理平台、研究CRM业务流与进行个性化二开的开发者参考。1. 拿到一套 CRM 旗舰版源码先别急着改代码很多做企业信息化的朋友拿到「某CRM旗舰版功能齐全客户管理系统源码.zip」这类压缩包第一反应是解压、找入口文件、把数据库一挂然后打开浏览器看首页能不能跑起来。这个顺序本身没错但真正决定这套源码能不能落地的不是首页能不能打开而是客户、商机、合同、跟进记录这几张核心表的关系有没有理清。CRM 系统跟博客、商城不一样它的价值全在数据流转上一条线索怎么变成客户客户怎么挂上商机商机怎么推进到合同合同回款怎么回写到客户视图。这套链路只要断一环功能再齐全也只是个空壳。这篇文章面向三类人一是手里已经拿到这套源码、想二次开发或私有化部署的开发者二是想拿它做课程设计或练手项目、需要快速理解架构的学生三是评估要不要基于它做定制交付的技术负责人。我会按「先看懂数据模型 → 再跑通部署 → 再改一个真实需求 → 最后避坑」的顺序讲中间给到能直接抄的命令和配置。源码类项目最怕的就是玄学问题比如本地能跑服务器报错、定时任务不执行、导出乱码这些我都会拆开说清楚。2. 拆开压缩包先看什么目录结构与技术栈判断2.1 从文件后缀和目录名反推技术栈解压之后不要急着打开 IDE先用命令行把目录树扫一遍重点看配置文件和后缀分布。常见的 CRM 源码无非几种组合PHP 系ThinkPHP / Laravel、Java 系Spring Boot MyBatis、Python 系Django / Flask。判断方法很直接看根目录有没有pom.xml、composer.json、requirements.txt、package.json这几个文件。# 解压后进入目录先看一级结构 unzip 某CRM旗舰版功能齐全客户管理系统源码.zip -d crm-src cd crm-src ls -la # 统计各语言文件数量快速判断主技术栈 find . -type f -name *.php | wc -l find . -type f -name *.java | wc -l find . -type f -name *.py | wc -l find . -type f -name *.vue | wc -l # 找配置文件这是判断框架最准的线索 find . -maxdepth 3 -name pom.xml -o -name composer.json -o -name requirements.txt -o -name application.yml -o -name .env*这段命令的逻辑是先看整体再按后缀计数最后定位配置文件。参数上-maxdepth 3是为了避免在node_modules或vendor里翻太久。如果*.php数量几百上千基本就是 PHP 系如果*.java多且根目录有pom.xml那就是 Spring Boot 系。这一步的意义在于不同技术栈的部署方式和二次开发入口完全不同选错方向后面全是白费功夫。2.2 数据库脚本是理解业务的地图CRM 源码里最值钱的文件不是控制器而是那个.sql文件。它定义了客户表、联系人表、商机表、合同表、回款表、跟进记录表之间的外键和索引。我一般会先把 SQL 导入一个空库然后用工具生成 ER 图或者直接查information_schema看表关系。-- 查看所有表及注释快速定位核心业务表 SELECT TABLE_NAME, TABLE_COMMENT FROM information_schema.TABLES WHERE TABLE_SCHEMA crm_db ORDER BY TABLE_NAME; -- 查看客户表结构重点看外键和索引 SHOW CREATE TABLE crm_customer; -- 查商机表与客户表的关联字段 SELECT COLUMN_NAME, REFERENCED_TABLE_NAME, REFERENCED_COLUMN_NAME FROM information_schema.KEY_COLUMN_USAGE WHERE TABLE_SCHEMA crm_db AND REFERENCED_TABLE_NAME IS NOT NULL;第一条查表注释能快速知道每张表干什么第二条看客户表的完整定义重点确认owner_id负责人、create_time、status这些字段的类型和索引第三条查外键关系理清商机、合同是怎么挂到客户上的。参数上把crm_db换成你实际导入的库名即可。如果源码没有外键约束很多 CRM 为了性能故意不加那就得靠字段命名规律去猜比如customer_id、opportunity_id这种。提示如果 SQL 文件里用了utf8mb4但你的 MySQL 版本低于 5.5导入会报错先确认版本再动手。2.3 配置文件里的三个关键项不管什么技术栈配置文件里一定有三个东西要改数据库连接、缓存/会话存储、文件上传路径。以常见的 Spring Boot 为例application.yml里重点看这几段。spring: datasource: url: jdbc:mysql://127.0.0.1:3306/crm_db?useUnicodetruecharacterEncodingutf8mb4 username: root password: your_password redis: host: 127.0.0.1 port: 6379 database: 0 servlet: multipart: max-file-size: 50MB max-request-size: 100MB crm: upload: path: /data/crm/upload/ url-prefix: /static/upload/datasource.url里的characterEncodingutf8mb4必须写否则客户姓名里的生僻字会变问号。redis如果源码里用来存 session 或验证码不配的话登录会一直失败。upload.path是附件和导入文件的落盘位置这个目录必须提前建好并给写权限否则上传客户 Excel 时会报 500。我见过太多人卡在「登录没反应」最后发现是 Redis 没启动。3. 本地跑通的最小路径从建库到登录后台3.1 建库导数据与依赖安装先把数据库准备好再装依赖最后启动。顺序反了会出现「表不存在」或「依赖冲突」的报错排查起来很烦。# 1. 创建数据库字符集必须 utf8mb4 mysql -uroot -p -e CREATE DATABASE crm_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; # 2. 导入 SQL 脚本 mysql -uroot -p crm_db ./sql/crm_init.sql # 3. 如果是 Java Maven 项目装依赖并打包 mvn clean package -DskipTests # 4. 如果是 PHP 项目装 Composer 依赖 composer install --no-dev # 5. 启动以 Spring Boot 为例 java -jar target/crm-1.0.0.jar --spring.profiles.activedev-DskipTests是为了跳过测试类很多源码的测试用例依赖外部服务不跳过会卡住。--spring.profiles.activedev指定用开发配置避免连到生产库。PHP 项目的话composer install --no-dev不装开发依赖速度快很多。启动后看日志里有没有Started Application in x seconds有就说明服务起来了。3.2 默认账号与权限表排查后台登录不进去九成是账号密码不对或者权限表没数据。先查用户表。-- 查管理员账号密码通常是 MD5 或 BCrypt SELECT id, username, password, status FROM sys_user WHERE username admin; -- 查角色和权限关联 SELECT u.username, r.role_name, m.permission FROM sys_user u JOIN sys_user_role ur ON u.id ur.user_id JOIN sys_role r ON ur.role_id r.id JOIN sys_role_menu rm ON r.id rm.role_id JOIN sys_menu m ON rm.menu_id m.id WHERE u.username admin;如果password是 32 位大概率是 MD5可以用在线工具或SELECT MD5(123456)验证。如果是$2a$开头那是 BCrypt不能直接改得用代码生成。status字段如果是 0 或 2说明账号被禁用改成 1 再试。权限表没数据的话后台菜单会是空的这时候要么手动插数据要么找源码里的初始化脚本重新跑。3.3 前端资源与接口联调现在很多 CRM 源码是前后端分离的后端跑在 8080前端跑在 3000 或 5173。前端启动前先看package.json里的scripts。# 进入前端目录 cd crm-web # 装依赖国内建议换源 npm install --registryhttps://registry.npmmirror.com # 开发模式启动 npm run dev # 生产打包 npm run build--registry换成国内源是为了避免下载超时。启动后如果页面能打开但接口 404检查vite.config.js或vue.config.js里的proxy配置把/api代理到后端地址。常见坑是代理配了但后端没开跨域浏览器控制台会报 CORS 错误这时候要么后端加CrossOrigin要么前端继续用代理。注意前端打包后的dist目录要放到后端静态资源目录下或者用 Nginx 单独托管否则刷新页面会 404。4. 二次开发实战给客户列表加一个扫码采集入口4.1 需求拆解与表结构扩展「crm管理系统结合扫码采集」是现在很实际的需求销售参加展会客户扫二维码填信息直接进 CRM 线索池。实现路径分三步建一张扫码记录表、写一个公开的表单页面、提交后写入客户表并标记来源。-- 扫码采集记录表 CREATE TABLE crm_scan_record ( id BIGINT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(50) COMMENT 客户姓名, phone VARCHAR(20) COMMENT 手机号, company VARCHAR(100) COMMENT 公司名称, source VARCHAR(50) DEFAULT scan COMMENT 来源, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, status TINYINT DEFAULT 0 COMMENT 0待跟进 1已转化 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;字段设计上phone加普通索引方便去重status用来区分是否已经转成正式客户。source固定为scan后续统计渠道效果时直接GROUP BY source就行。4.2 后端接口与去重逻辑接口要做两件事接收表单、按手机号去重后写入。如果手机号已存在更新记录而不是新增。PostMapping(/api/scan/collect) public Result collect(RequestBody ScanForm form) { // 1. 参数校验 if (StringUtils.isBlank(form.getPhone())) { return Result.fail(手机号不能为空); } // 2. 按手机号查重 Customer exist customerMapper.selectByPhone(form.getPhone()); if (exist ! null) { // 已存在则更新来源和跟进状态 exist.setSource(scan); customerMapper.updateById(exist); return Result.ok(已存在已更新来源); } // 3. 写入客户表 Customer customer new Customer(); customer.setName(form.getName()); customer.setPhone(form.getPhone()); customer.setCompany(form.getCompany()); customer.setSource(scan); customer.setOwnerId(0L); // 待分配 customerMapper.insert(customer); // 4. 记录扫码日志 scanRecordMapper.insert(buildRecord(form)); return Result.ok(提交成功); }selectByPhone走的是手机号索引速度很快。ownerId设为 0 表示待分配后续可以做个定时任务或手动分配给销售。返回结果里区分「已存在」和「新增」前端可以给不同提示。这段代码的关键是去重不然同一个客户扫两次就变成两条线索销售跟进时会打架。4.3 前端表单与二维码生成前端用一个简单的 H5 页面配合二维码工具生成入口。// 提交表单 async function submitForm() { const data { name: document.getElementById(name).value, phone: document.getElementById(phone).value, company: document.getElementById(company).value }; // 简单校验 if (!/^1[3-9]\d{9}$/.test(data.phone)) { alert(手机号格式不对); return; } const res await fetch(/api/scan/collect, { method: POST, headers: { Content-Type: application/json }, body: JSON.stringify(data) }); const result await res.json(); alert(result.msg); }手机号正则^1[3-9]\d{9}$覆盖了国内主流号段。提交用fetch而不是表单直接 post是为了拿到 JSON 结果做提示。二维码那边用任意库把页面 URL 生成图片打印出来就行展会现场贴桌上让客户扫。提示公开接口一定要加频率限制否则会被脚本刷爆。常见做法是用 Redis 记录 IP 提交次数超过阈值直接拒绝。5. 部署与性能避坑那些让你加班到凌晨的细节5.1 定时任务不执行现象、原因、解决现象客户跟进提醒、商机超时预警这些定时任务本地跑得好好的服务器上就是不发。原因多数是时区问题。服务器用 UTC代码里写的是cron 0 0 9 * * ?实际执行时间是北京时间下午 5 点。另一个原因是多实例部署两个节点同时跑任务数据库里出现重复提醒。解决启动参数加-Duser.timezoneAsia/Shanghai或者在配置文件里指定时区。多实例的话引入分布式锁用 Redis 的SETNX或 Quartz 的集群模式保证同一时间只有一个节点执行。5.2 导出 Excel 乱码或超时现象客户列表导出小数据量正常超过一万条就超时或者文件打不开。原因一次性查全量数据放内存JVM 直接 OOM或者用HttpServletResponse输出时没设字符集中文变乱码。解决分页查询每批 5000 条写入 EasyExcel 的ExcelWriter最后统一关闭。响应头设置response.setContentType(application/vnd.ms-excel;charsetutf-8)文件名用URLEncoder.encode处理。数据量特别大的话改成异步导出前端轮询进度导出完给下载链接。5.3 附件上传路径权限与 Nginx 配置现象上传客户合同附件报 500日志里写Permission denied。原因upload.path指向的目录不存在或者运行服务的用户没有写权限。解决mkdir -p /data/crm/upload chown -R www:www /data/crm/upload把目录所有者改成运行服务的用户。Nginx 那边加一段静态资源映射让上传的文件能通过 URL 访问。location /static/upload/ { alias /data/crm/upload/; expires 7d; }alias和root的区别要注意alias是替换匹配路径root是拼接配错了会 404。5.4 数据库连接池耗尽现象系统跑一段时间后所有接口变慢最后报Connection is not available。原因连接池最大连接数设太小或者代码里有地方拿了连接没关。解决HikariCP 的话把maximum-pool-size调到 20 到 50同时开leak-detection-threshold查泄漏。代码里所有Connection、Statement、ResultSet都要在finally里关或者用 try-with-resources。MyBatis 的话检查有没有手写 JDBC 的地方。5.5 缓存与数据库不一致现象改了客户名称列表页还是旧名字刷新几次才变。原因用了 Redis 缓存客户信息更新数据库后没删缓存或者删了但前端还有本地缓存。解决更新逻辑改成「先更新数据库再删除缓存」删除失败就重试。查询时如果缓存没有从数据库读并回写。前端接口加Cache-Control: no-cache头避免浏览器缓存。这个坑很经典血泪经验就是别用「先删缓存再更新数据库」并发下必出脏数据。6. 让这套 CRM 源码真正值钱的三个进阶动作第一件事把客户去重做成可配置规则。默认按手机号去重但有些行业按公司名去重更合理。在配置表里加一个dedup_rule字段支持phone、company、phone_company三种模式代码里用策略模式切换。这样交付给不同客户时不用改代码改配置就行。第二件事给客户列表加一个「最后跟进时间」的冗余字段。CRM 里最常用的查询是「超过 7 天没跟进的客户」如果每次都要 join 跟进记录表再 group by数据量大了会很慢。在客户表加last_follow_time每次新增跟进记录时更新这个字段查询时直接WHERE last_follow_time DATE_SUB(NOW(), INTERVAL 7 DAY)走索引秒出。第三件事把权限控制从菜单级细化到数据级。现在很多 CRM 源码的权限只控制「能不能看客户菜单」但实际业务里销售 A 只能看自己的客户主管能看团队的老板能看全部。实现方式是在客户表加owner_id和dept_id查询时根据当前用户角色拼接WHERE条件。这个改动涉及所有列表接口建议抽一个DataScopeInterceptor统一处理别在每个 Service 里手写。进阶动作改动范围收益风险去重规则可配置配置表 去重逻辑交付灵活规则冲突时需明确优先级最后跟进时间冗余客户表 跟进模块查询快 10 倍数据一致性需事务保证数据级权限所有列表接口符合真实业务拦截器写错会越权这三个动作做完这套源码就从「能跑」变成「能交付」。我自己的习惯是每改一个模块先在测试库跑一遍全量回归重点看客户、商机、合同三个列表的查询结果对不对。源码类项目最怕的就是改 A 崩 B所以改之前先备份数据库改之后用git diff过一遍代码确认没有误删。希望帮到你。本文还有配套的精品资源点击获取