简介这是一套面向高校计算机及相关专业毕业设计、课程设计场景的JavaWeb社区医疗系统项目源码适合需要完整可运行项目作为参考或二次开发的学习者。压缩包共包含536个文件大小约28.52MB以Java、JSP后端代码为核心搭配jar依赖库、CSS与JS前端静态资源、SQL数据库脚本以及XML配置等文件目录结构清晰便于直接导入开发工具运行调试。目前已有76人学习浏览属于轻量而典型的教学型案例项目。从工程文件来看前端采用Bootstrap和FontAwesome搭建界面后端由Java与JSP实现业务逻辑同时配有数据库脚本和Eclipse工程配置便于读者梳理项目结构、理解前后端交互方式项目整体也适合作为课程设计或毕业设计的原型基础作者提示需能看懂代码并愿意自行调试整体性价比较高。1. 社区医疗系统源码.zip下载之前先决定你是要跑还是要改拿到“社区医疗系统源码.zip”那一刻先别急着解压问自己一句这份代码是准备在本机做学习演示还是要接真实业务做二次开发。两种目标的判断标准完全不同前者关心启动过程和界面截图后者关心权限模型、数据归属和代码里埋着的暗坑。绝大多数从网上下载到的社区医疗系统源码包属于培训机构结业项目或信息科外包交付的裁剪版结构看着完整真正能跑通核心业务链路的却不多。一份合格的社区卫生服务系统至少覆盖患者建档、慢病随访、门诊处方和药品库存四条业务线缺掉任何一条线上都没法用。这篇按实际处理顺序展开先拆包判断技术栈再在本地把前后端跑起来然后演示一个业务字段从数据库改到前端页面的完整路径最后补上线前值得做的安全检查与体检接口。2. 拆解社区医疗系统源码目录、技术栈与核心业务表拿到压缩包后不要双击直接在压缩软件里看先解压到不带空格的路径例如/data/community-health或D:\dev\community-health。很多下载包是从 Windows 环境直接打包的路径里有中文或空格时后面的 Maven、Node 和 MySQL 脚本导入会冒出各种编码问题先排除这个变量能省下大量排错时间。2.1 从源码根目录判断打包质量解压后第一件事是看根目录不急着点开 README。一份结构完整的社区医疗系统源码通常能一眼看到三个目录community-health/ ├── backend/ # Java 后端工程Spring Boot │ ├── pom.xml │ └── src/main/java/com/community/ │ ├── controller/ # 接收 HTTP 请求的控制器 │ ├── service/ # 业务逻辑层 │ ├── mapper/ # MyBatis 数据访问层 │ └── entity/ # 数据库表映射实体 ├── frontend/ # 前端工程Vue2 或 Vue3 │ ├── package.json │ └── src/ │ ├── api/ # 后端接口封装 │ ├── router/ # 页面路由 │ └── views/ # 页面组件 ├── sql/ # 建库建表脚本 │ └── community_health.sql └── README.md有三个目录只是第一关。第二关是打开sql/里的脚本看它是完整的建表加初始数据脚本还是只有几张表的示意。完整脚本通常按模块分节有patient_info、registration、prescription、drug_stock这些表并且带INSERT INTO初始化管理员账号。如果脚本只有 create table 没有初始数据后面登录时会卡在“没有账号可用”这个问题上。另外一个判断点是pom.xml的依赖规模。只依赖spring-boot-starter-web、mybatis-plus-boot-starter、mysql-connector-java三件套的是轻量单体结构适合二次开发如果出现spring-cloud-starter-gateway、nacos、seata那是大型团队的微服务裁剪版启动顺序和配置复杂度都高一大截本机演示成本很高。2.2 社区医疗系统的核心业务模块与对应数据表无论前端页面长什么样社区医疗系统落地的核心都在表和表之间的关系上。下面这张表是处理过的多数社区医疗系统源码里最常出现的几张业务表字段名略有差异但业务含义基本一致。业务模块核心表关键字段说明患者档案patient_infoid_card, patient_name, phone, address建档、查询、修改的底表慢病随访follow_up_recordpatient_id, blood_pressure, follow_date, status高血压、糖尿病等随访记录挂号门诊registrationpatient_id, dept_id, doctor_id, visit_time预约、挂号、分诊处方收费prescriptionpatient_id, total_amount, pay_status开方、划价、收费药品库存drug_stockdrug_id, batch_no, stock_qty, alert_qty入库、出库、库存预警系统用户sys_userusername, password, role_id医生、护士、管理员账号审查业务表的时候重点关注patient_info和follow_up_record之间的关系。常规设计里follow_up_record通过patient_id关联患者“一次随访记录”和“一个患者”是多对一关系。如果源码里出现的是patient_name字符串直接存在随访表里而不是患者主键说明这套源码的数据模型偏向 demo后续做统计报表会非常痛苦。2.3 用 pom.xml 和 application.yml 反推技术选型打开backend/pom.xml看 Spring Boot 版本号基本能推断这套代码适合在什么 JDK 上运行。parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version2.7.18/version /parent dependencies dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.5/version /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version8.0.33/version /dependency /dependenciesSpring Boot 2.7.x 支持到 JDK 17但多数下载包默认按 JDK 8 编译。如果你本机装的是 JDK 17启动时可能报UnsupportedClassVersionError此时要么把pom.xml里的java.version改成 11 或 17要么干脆用 JDK 8 跑。MyBatis Plus 3.5.5 是社区医疗系统源码里出现频率很高的依赖。注意区分如果源码里大量使用TableField、TableName、LambdaQueryWrapper说明封装程度较高写 SQL 的地方不多改造时优先改实体注解反之大量出现mapper/xxxMapper.xml手写 SQL说明是半自动模式业务调整需要同步改 XML 里的where、set条件。如果根目录看到的是thinkphp、application/、public/index.php这套源码是 PHP 技术栈。PHP 版社区医疗系统多为单机部署数据库通常是 MySQL 5.7跑法不同但按业务表去理解模块的方法完全一样。还有一部分老包是 C# 桌面程序属于医院内部使用的单机版不在同一讨论线内遇到后建议谨慎投入精力。3. 本地跑通社区医疗系统源码JDK 17 MySQL 8 Node 的最小组合从 zip 包运行起来的关键不在代码而在环境版本。社区医疗系统这种单体项目对版本敏感度很高JDK、MySQL、Node 三个版本对不上一连串报错能消耗掉大半天。这里给出一套经过验证的最小组合JDK 8 或 11、MySQL 8.0、Node 16 或 18按下面顺序操作。3.1 初始化数据库与导入 SQL 脚本先建库再导表数据库名用脚本里出现的名称。如果脚本里没有建库语句就统一创建community_health。mysql -uroot -p -e CREATE DATABASE IF NOT EXISTS community_health DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; mysql -uroot -p community_health sql/community_health.sql mysql -uroot -p -e USE community_health; SHOW TABLES;第一条命令创建数据库指定字符集 utf8mb4 和排序规则 utf8mb4_unicode_ci这样可以正常存储患者姓名里的生僻字和早期系统留下的特殊符号。第二条命令把建表脚本导入该库。第三条命令验证导入结果如果SHOW TABLES输出的表数量和你从源码里看到的不一致基本可以确定脚本不完整。导入时报Unknown collation之类的错通常是脚本文件头和 MySQL 版本不匹配。多数老源码脚本声明了latin1或utf8导入时可以直接打开 SQL 文件把COLLATElatin1_swedish_ci全部替换成COLLATEutf8mb4_unicode_ci。如果 SQL 文件用记事本打开是乱码改用 VS Code 打开并以 UTF-8 重新保存。3.2 修改数据库连接与缓存配置导入成功后打开backend/src/main/resources/application.yml重点看spring.datasource这一段。spring: datasource: url: jdbc:mysql://localhost:3306/community_health?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalseallowPublicKeyRetrievaltrue username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver redis: host: localhost port: 6379 database: 0连接 URL 里的参数每个都有存在的理由看不明白就别随意删参数作用踩坑点characterEncodingutf8保证中文不乱码表和库的字符集不一致时光改这里不够serverTimezoneAsia/Shanghai设置时区不写时可能报时区错误或日期差 8 小时useSSLfalse本地调试时跳过证书校验线上合规场景建议打开allowPublicKeyRetrievaltrue适配 MySQL 8 的 caching_sha2_password不写会报 Public Key Retrieval not allowed如果源码里还配置了 Redis本地没有一个启动着的 Redis 实例会直接导致启动失败。Windows 可以先下载 Redis 压缩包解压后在目录执行redis-server.exe redis.windows.confLinux 执行systemctl start redis。确认 Redis 起来了再启动后端否则报错会指向数据库连接真正原因却在缓存层。3.3 分别启动前后端并验证登录接口后端启动命令如下推荐直接用 Maven 自带插件不额外安装 Tomcat。cd backend mvn spring-boot:run编译成功看到Started CommunityApplication in x.xxx seconds说明后端起来了。控制台报端口被占用时执行netstat -ano | findstr :8080Windows或lsof -i:8080Linux找到进程号后结束占用进程或者直接在application.yml里把server.port改成 8081。另开一个终端启动前端。cd frontend npm install npm run devnpm install慢是正常的换成国内镜像源可提速npm config set registry https://registry.npmmirror.com前后端都起来后用 curl 直接验证后端登录接口不依赖页面curl -sS -X POST http://localhost:8080/api/auth/login \ -H Content-Type: application/json \ -d {username:admin,password:admin123}返回 JSON 里带token或accessToken字段说明接口链路通畅。如果返回 401排查两个位置一是sys_user表里有没有这个账号二是源码里 Controller 接收的是RequestBody还是RequestParam。前者用 JSON 传参后者要求usernameadminpasswordadmin123这种格式。不少源码包前端页面能登录curl 却不行问题就出在这里。4. 改造社区医疗系统源码把“家庭医生签约编号”从数据库改到前端系统跑通只是开始真正的日常工作是改需求。社区医疗系统最常见的改动是加字段、加页面、加接口。拿“患者档案里要新增一个家庭医生签约编号”举例完整路径涉及数据库、后端实体、控制器、前端页面四层缺一层都会造成线上功能“半残”。4.1 先理清一次数据提交要过哪几层改动前先确认这条链路的顺序。前端表单提交后请求先到PatientController控制器把 JSON 转成 DTO 或实体再交给PatientServiceService 调用PatientMapper最终由 MyBatis 把数据写进patient_info表。查询时反向执行一遍。很多人改字段时只改前端页面和后端实体漏了数据库字段和 Mapper XML结果前端点保存提示成功数据库里却没值。一条典型的请求链路如下views/patient/edit.vue - api/patient.js - PatientController.java - PatientService.java - PatientMapper.xml - MySQL4.2 六步完成一个业务字段的完整改造第一步给数据库表加字段。直接在命令行执行ALTER TABLE patient_info ADD COLUMN family_doctor_no VARCHAR(32) DEFAULT NULL COMMENT 家庭医生签约编号;这里的VARCHAR(32)用来存编号类字段已经足够不需要用INT因为签约编号可能带字母和横杠。加完字段后执行DESC patient_info确认列已经存在。第二步实体类Patient.java增加属性。这里区分两种情况如果项目用的是 MyBatis Plus写法是TableName(patient_info) public class Patient { TableId(type IdType.AUTO) private Long id; private String patientName; TableField(family_doctor_no) private String familyDoctorNo; }TableField里的值必须和数据库列名完全一致。MyBatis Plus 默认开启驼峰转换familyDoctorNo会自动映射family_doctor_no但保险起见写上TableField更不容易出错。第三步新增 DTO 接收前端参数不要直接拿实体接收。实体里可能还有createTime、updateTime这种不让前端传的字段直接绑定实体会导致前端趁机覆盖敏感字段比如把支付状态改成已支付。Getter Setter public class PatientDTO { private Long id; private String patientName; private String familyDoctorNo; }第四步在PatientMapper.xml里增加更新语句。用动态set而不是全部字段重写避免覆盖未传值的字段update idupdatePatient parameterTypecom.community.entity.Patient update patient_info set if testpatientName ! nullpatient_name #{patientName},/if if testfamilyDoctorNo ! nullfamily_doctor_no #{familyDoctorNo},/if /set where id #{id} /update这个写法有三个好处只能更新非空字段传什么改什么#{familyDoctorNo}是预编译参数能挡住 SQL 拼接注入不会把update_time之外的其他字段意外置空。第五步Controller 层把请求参数转给 ServicePutMapping(/patient/{id}) public Result updatePatient(PathVariable(id) Long id, RequestBody PatientDTO dto) { Patient patient new Patient(); patient.setId(id); patient.setPatientName(dto.getPatientName()); patient.setFamilyDoctorNo(dto.getFamilyDoctorNo()); patientService.updateById(patient); return Result.ok(); }注意这里把DTO转换成Patient实体再传给服务层数据流是单向的前端 → DTO → 实体 → Mapper。第六步前端views/patient/edit.vue的el-form里增加表单项el-form-item label签约编号 el-input v-modelform.familyDoctorNo placeholder请输入家庭医生签约编号 / /el-form-item列表页el-table也要加上对应列否则前端看不到新增字段el-table-column propfamilyDoctorNo label签约编号 width120 /这里的prop必须和接口返回 JSON 的字段名保持一致大小写敏感。接口返回的是family_doctor_no而页面写familyDoctorNo就会显示空白。4.3 改字段时最容易碰到的三个坑第一个坑是驼峰映射不生效。如果项目没有开启map-underscore-to-camel-case: trueMyBatis 不会自动把family_doctor_no映射成familyDoctorNo。配置位置在application.ymlmybatis: configuration: map-underscore-to-camel-case: trueMyBatis Plus 项目可以写成mybatis-plus: configuration: map-underscore-to-camel-case: true第二个坑是前端提交格式不对。源码里如果 Controller 用RequestBody接收前端必须设置请求头Content-Type: application/json提交体是 JSON 字符串。很多包里的公共请求方法已经封装好改造时不要自己又写一个qs.stringify会导致后端收到Unsupported Media Type。第三个坑是实体字段被自动填充覆盖。检查实体里有没有TableField(fill FieldFill.INSERT_UPDATE)这种注解如果有新增字段也加上同样的填充策略否则保存时createTime和updateTime会互相干扰。遇到页面提示”保存成功“但数据库只有部分字段有值优先打开后端日志把 Mapper 执行的真实 SQL 打出来。mybatis-plus: configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl开启后每次数据库操作都会打印完整 SQL 和参数比如Preparing: update patient_info SET family_doctor_no? where id?一眼就能看出漏了哪个字段。5. 上线前给社区医疗系统源码做的最小安全体检与接口验证代码能在本机跑通不代表能直接搬到线上。下载的源码在安全方面通常只剩个架子下面的检查清单按投入产出比排序每一步都能发现实际问题。5.1 扫一遍默认账号和明文密码先用一条命令扫配置和脚本里的密码痕迹grep -rniE password|pwd|secret backend/src/main/resources --include*.yml --include*.yaml --include*.properties | head -30输出结果里如果看到spring.datasource.password: 123456只能算是常规操作。重点找两类问题一是代码里写死数据库连接密码二是sys_user表初始数据里所有账号共用同一个 MD5 密码。MD5 存储的密码在现在算力下基本等于明文。处理方式是把DEFAULT 123456这种初始数据替换成 BCrypt 哈希值并在首次登录后强制改密。5.2 补上越权读取与操作日志社区医疗系统源码最常见的越权路径是这个模式登录用户拿着一个患者 ID 就能查别人档案。原因往往是 Controller 只做了“是否登录”校验没做“该用户是否有权查看该患者”。补一个最小权限判断GetMapping(/patient/{id}) public Result getPatient(PathVariable Long id, HttpServletRequest request) { Long currentUserId LoginUtil.getCurrentId(); if (!patientService.canAccess(currentUserId, id)) { auditLogService.log(deny_get_patient, request.getRemoteAddr(), id.toString()); return Result.error(403, 无权查看该档案); } auditLogService.log(get_patient, request.getRemoteAddr(), id.toString()); return Result.ok(patientService.getById(id)); }这里的核心动作是“先鉴权再查库”不是先查出患者信息再做判断。除了越权看有没有统一的操作日志入口。社区医疗涉及患者隐私谁、在什么时间、用什么 IP、对哪个患者档案做了读取或修改至少要有记录可查。手工log.info不够用最好走统一的auditLogService单独存一张审计表别人接手时也更容易知道这套系统的操作轨迹长什么样。5.3 加一个不依赖 Actuator 的 /health 接口很多从 zip 包来的源码没有引入spring-boot-starter-actuator。与其为了一个健康检查把整个监控模块带进来不如直接手写一个轻接口RestController RequestMapping(/api/health) public class HealthController { private final DataSource dataSource; public HealthController(DataSource dataSource) { this.dataSource dataSource; } GetMapping public MapString, Object check() { MapString, Object result new HashMap(); try (Connection conn dataSource.getConnection()) { result.put(status, UP); result.put(database, conn.isValid(2)); } catch (SQLException e) { result.put(status, DOWN); result.put(database, false); } return result; } }conn.isValid(2)表示在 2 秒内完成一次数据库连通性探测能真实反映系统核心依赖是否可用而不是只回一个固定的UP字符串。这个接口配合前置 Nginx 或容器编排服务的定时探测能避免“进程活着但数据库连不上”的假在线状态。返回结构保持status和database两个键后续接入监控系统时不需要改动业务代码。本文还有配套的精品资源点击获取 社区医疗系统源码实战：从部署启动到业务改造与安全上线
简介这是一套面向高校计算机及相关专业毕业设计、课程设计场景的JavaWeb社区医疗系统项目源码适合需要完整可运行项目作为参考或二次开发的学习者。压缩包共包含536个文件大小约28.52MB以Java、JSP后端代码为核心搭配jar依赖库、CSS与JS前端静态资源、SQL数据库脚本以及XML配置等文件目录结构清晰便于直接导入开发工具运行调试。目前已有76人学习浏览属于轻量而典型的教学型案例项目。从工程文件来看前端采用Bootstrap和FontAwesome搭建界面后端由Java与JSP实现业务逻辑同时配有数据库脚本和Eclipse工程配置便于读者梳理项目结构、理解前后端交互方式项目整体也适合作为课程设计或毕业设计的原型基础作者提示需能看懂代码并愿意自行调试整体性价比较高。1. 社区医疗系统源码.zip下载之前先决定你是要跑还是要改拿到“社区医疗系统源码.zip”那一刻先别急着解压问自己一句这份代码是准备在本机做学习演示还是要接真实业务做二次开发。两种目标的判断标准完全不同前者关心启动过程和界面截图后者关心权限模型、数据归属和代码里埋着的暗坑。绝大多数从网上下载到的社区医疗系统源码包属于培训机构结业项目或信息科外包交付的裁剪版结构看着完整真正能跑通核心业务链路的却不多。一份合格的社区卫生服务系统至少覆盖患者建档、慢病随访、门诊处方和药品库存四条业务线缺掉任何一条线上都没法用。这篇按实际处理顺序展开先拆包判断技术栈再在本地把前后端跑起来然后演示一个业务字段从数据库改到前端页面的完整路径最后补上线前值得做的安全检查与体检接口。2. 拆解社区医疗系统源码目录、技术栈与核心业务表拿到压缩包后不要双击直接在压缩软件里看先解压到不带空格的路径例如/data/community-health或D:\dev\community-health。很多下载包是从 Windows 环境直接打包的路径里有中文或空格时后面的 Maven、Node 和 MySQL 脚本导入会冒出各种编码问题先排除这个变量能省下大量排错时间。2.1 从源码根目录判断打包质量解压后第一件事是看根目录不急着点开 README。一份结构完整的社区医疗系统源码通常能一眼看到三个目录community-health/ ├── backend/ # Java 后端工程Spring Boot │ ├── pom.xml │ └── src/main/java/com/community/ │ ├── controller/ # 接收 HTTP 请求的控制器 │ ├── service/ # 业务逻辑层 │ ├── mapper/ # MyBatis 数据访问层 │ └── entity/ # 数据库表映射实体 ├── frontend/ # 前端工程Vue2 或 Vue3 │ ├── package.json │ └── src/ │ ├── api/ # 后端接口封装 │ ├── router/ # 页面路由 │ └── views/ # 页面组件 ├── sql/ # 建库建表脚本 │ └── community_health.sql └── README.md有三个目录只是第一关。第二关是打开sql/里的脚本看它是完整的建表加初始数据脚本还是只有几张表的示意。完整脚本通常按模块分节有patient_info、registration、prescription、drug_stock这些表并且带INSERT INTO初始化管理员账号。如果脚本只有 create table 没有初始数据后面登录时会卡在“没有账号可用”这个问题上。另外一个判断点是pom.xml的依赖规模。只依赖spring-boot-starter-web、mybatis-plus-boot-starter、mysql-connector-java三件套的是轻量单体结构适合二次开发如果出现spring-cloud-starter-gateway、nacos、seata那是大型团队的微服务裁剪版启动顺序和配置复杂度都高一大截本机演示成本很高。2.2 社区医疗系统的核心业务模块与对应数据表无论前端页面长什么样社区医疗系统落地的核心都在表和表之间的关系上。下面这张表是处理过的多数社区医疗系统源码里最常出现的几张业务表字段名略有差异但业务含义基本一致。业务模块核心表关键字段说明患者档案patient_infoid_card, patient_name, phone, address建档、查询、修改的底表慢病随访follow_up_recordpatient_id, blood_pressure, follow_date, status高血压、糖尿病等随访记录挂号门诊registrationpatient_id, dept_id, doctor_id, visit_time预约、挂号、分诊处方收费prescriptionpatient_id, total_amount, pay_status开方、划价、收费药品库存drug_stockdrug_id, batch_no, stock_qty, alert_qty入库、出库、库存预警系统用户sys_userusername, password, role_id医生、护士、管理员账号审查业务表的时候重点关注patient_info和follow_up_record之间的关系。常规设计里follow_up_record通过patient_id关联患者“一次随访记录”和“一个患者”是多对一关系。如果源码里出现的是patient_name字符串直接存在随访表里而不是患者主键说明这套源码的数据模型偏向 demo后续做统计报表会非常痛苦。2.3 用 pom.xml 和 application.yml 反推技术选型打开backend/pom.xml看 Spring Boot 版本号基本能推断这套代码适合在什么 JDK 上运行。parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version2.7.18/version /parent dependencies dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.5/version /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version8.0.33/version /dependency /dependenciesSpring Boot 2.7.x 支持到 JDK 17但多数下载包默认按 JDK 8 编译。如果你本机装的是 JDK 17启动时可能报UnsupportedClassVersionError此时要么把pom.xml里的java.version改成 11 或 17要么干脆用 JDK 8 跑。MyBatis Plus 3.5.5 是社区医疗系统源码里出现频率很高的依赖。注意区分如果源码里大量使用TableField、TableName、LambdaQueryWrapper说明封装程度较高写 SQL 的地方不多改造时优先改实体注解反之大量出现mapper/xxxMapper.xml手写 SQL说明是半自动模式业务调整需要同步改 XML 里的where、set条件。如果根目录看到的是thinkphp、application/、public/index.php这套源码是 PHP 技术栈。PHP 版社区医疗系统多为单机部署数据库通常是 MySQL 5.7跑法不同但按业务表去理解模块的方法完全一样。还有一部分老包是 C# 桌面程序属于医院内部使用的单机版不在同一讨论线内遇到后建议谨慎投入精力。3. 本地跑通社区医疗系统源码JDK 17 MySQL 8 Node 的最小组合从 zip 包运行起来的关键不在代码而在环境版本。社区医疗系统这种单体项目对版本敏感度很高JDK、MySQL、Node 三个版本对不上一连串报错能消耗掉大半天。这里给出一套经过验证的最小组合JDK 8 或 11、MySQL 8.0、Node 16 或 18按下面顺序操作。3.1 初始化数据库与导入 SQL 脚本先建库再导表数据库名用脚本里出现的名称。如果脚本里没有建库语句就统一创建community_health。mysql -uroot -p -e CREATE DATABASE IF NOT EXISTS community_health DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; mysql -uroot -p community_health sql/community_health.sql mysql -uroot -p -e USE community_health; SHOW TABLES;第一条命令创建数据库指定字符集 utf8mb4 和排序规则 utf8mb4_unicode_ci这样可以正常存储患者姓名里的生僻字和早期系统留下的特殊符号。第二条命令把建表脚本导入该库。第三条命令验证导入结果如果SHOW TABLES输出的表数量和你从源码里看到的不一致基本可以确定脚本不完整。导入时报Unknown collation之类的错通常是脚本文件头和 MySQL 版本不匹配。多数老源码脚本声明了latin1或utf8导入时可以直接打开 SQL 文件把COLLATElatin1_swedish_ci全部替换成COLLATEutf8mb4_unicode_ci。如果 SQL 文件用记事本打开是乱码改用 VS Code 打开并以 UTF-8 重新保存。3.2 修改数据库连接与缓存配置导入成功后打开backend/src/main/resources/application.yml重点看spring.datasource这一段。spring: datasource: url: jdbc:mysql://localhost:3306/community_health?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalseallowPublicKeyRetrievaltrue username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver redis: host: localhost port: 6379 database: 0连接 URL 里的参数每个都有存在的理由看不明白就别随意删参数作用踩坑点characterEncodingutf8保证中文不乱码表和库的字符集不一致时光改这里不够serverTimezoneAsia/Shanghai设置时区不写时可能报时区错误或日期差 8 小时useSSLfalse本地调试时跳过证书校验线上合规场景建议打开allowPublicKeyRetrievaltrue适配 MySQL 8 的 caching_sha2_password不写会报 Public Key Retrieval not allowed如果源码里还配置了 Redis本地没有一个启动着的 Redis 实例会直接导致启动失败。Windows 可以先下载 Redis 压缩包解压后在目录执行redis-server.exe redis.windows.confLinux 执行systemctl start redis。确认 Redis 起来了再启动后端否则报错会指向数据库连接真正原因却在缓存层。3.3 分别启动前后端并验证登录接口后端启动命令如下推荐直接用 Maven 自带插件不额外安装 Tomcat。cd backend mvn spring-boot:run编译成功看到Started CommunityApplication in x.xxx seconds说明后端起来了。控制台报端口被占用时执行netstat -ano | findstr :8080Windows或lsof -i:8080Linux找到进程号后结束占用进程或者直接在application.yml里把server.port改成 8081。另开一个终端启动前端。cd frontend npm install npm run devnpm install慢是正常的换成国内镜像源可提速npm config set registry https://registry.npmmirror.com前后端都起来后用 curl 直接验证后端登录接口不依赖页面curl -sS -X POST http://localhost:8080/api/auth/login \ -H Content-Type: application/json \ -d {username:admin,password:admin123}返回 JSON 里带token或accessToken字段说明接口链路通畅。如果返回 401排查两个位置一是sys_user表里有没有这个账号二是源码里 Controller 接收的是RequestBody还是RequestParam。前者用 JSON 传参后者要求usernameadminpasswordadmin123这种格式。不少源码包前端页面能登录curl 却不行问题就出在这里。4. 改造社区医疗系统源码把“家庭医生签约编号”从数据库改到前端系统跑通只是开始真正的日常工作是改需求。社区医疗系统最常见的改动是加字段、加页面、加接口。拿“患者档案里要新增一个家庭医生签约编号”举例完整路径涉及数据库、后端实体、控制器、前端页面四层缺一层都会造成线上功能“半残”。4.1 先理清一次数据提交要过哪几层改动前先确认这条链路的顺序。前端表单提交后请求先到PatientController控制器把 JSON 转成 DTO 或实体再交给PatientServiceService 调用PatientMapper最终由 MyBatis 把数据写进patient_info表。查询时反向执行一遍。很多人改字段时只改前端页面和后端实体漏了数据库字段和 Mapper XML结果前端点保存提示成功数据库里却没值。一条典型的请求链路如下views/patient/edit.vue - api/patient.js - PatientController.java - PatientService.java - PatientMapper.xml - MySQL4.2 六步完成一个业务字段的完整改造第一步给数据库表加字段。直接在命令行执行ALTER TABLE patient_info ADD COLUMN family_doctor_no VARCHAR(32) DEFAULT NULL COMMENT 家庭医生签约编号;这里的VARCHAR(32)用来存编号类字段已经足够不需要用INT因为签约编号可能带字母和横杠。加完字段后执行DESC patient_info确认列已经存在。第二步实体类Patient.java增加属性。这里区分两种情况如果项目用的是 MyBatis Plus写法是TableName(patient_info) public class Patient { TableId(type IdType.AUTO) private Long id; private String patientName; TableField(family_doctor_no) private String familyDoctorNo; }TableField里的值必须和数据库列名完全一致。MyBatis Plus 默认开启驼峰转换familyDoctorNo会自动映射family_doctor_no但保险起见写上TableField更不容易出错。第三步新增 DTO 接收前端参数不要直接拿实体接收。实体里可能还有createTime、updateTime这种不让前端传的字段直接绑定实体会导致前端趁机覆盖敏感字段比如把支付状态改成已支付。Getter Setter public class PatientDTO { private Long id; private String patientName; private String familyDoctorNo; }第四步在PatientMapper.xml里增加更新语句。用动态set而不是全部字段重写避免覆盖未传值的字段update idupdatePatient parameterTypecom.community.entity.Patient update patient_info set if testpatientName ! nullpatient_name #{patientName},/if if testfamilyDoctorNo ! nullfamily_doctor_no #{familyDoctorNo},/if /set where id #{id} /update这个写法有三个好处只能更新非空字段传什么改什么#{familyDoctorNo}是预编译参数能挡住 SQL 拼接注入不会把update_time之外的其他字段意外置空。第五步Controller 层把请求参数转给 ServicePutMapping(/patient/{id}) public Result updatePatient(PathVariable(id) Long id, RequestBody PatientDTO dto) { Patient patient new Patient(); patient.setId(id); patient.setPatientName(dto.getPatientName()); patient.setFamilyDoctorNo(dto.getFamilyDoctorNo()); patientService.updateById(patient); return Result.ok(); }注意这里把DTO转换成Patient实体再传给服务层数据流是单向的前端 → DTO → 实体 → Mapper。第六步前端views/patient/edit.vue的el-form里增加表单项el-form-item label签约编号 el-input v-modelform.familyDoctorNo placeholder请输入家庭医生签约编号 / /el-form-item列表页el-table也要加上对应列否则前端看不到新增字段el-table-column propfamilyDoctorNo label签约编号 width120 /这里的prop必须和接口返回 JSON 的字段名保持一致大小写敏感。接口返回的是family_doctor_no而页面写familyDoctorNo就会显示空白。4.3 改字段时最容易碰到的三个坑第一个坑是驼峰映射不生效。如果项目没有开启map-underscore-to-camel-case: trueMyBatis 不会自动把family_doctor_no映射成familyDoctorNo。配置位置在application.ymlmybatis: configuration: map-underscore-to-camel-case: trueMyBatis Plus 项目可以写成mybatis-plus: configuration: map-underscore-to-camel-case: true第二个坑是前端提交格式不对。源码里如果 Controller 用RequestBody接收前端必须设置请求头Content-Type: application/json提交体是 JSON 字符串。很多包里的公共请求方法已经封装好改造时不要自己又写一个qs.stringify会导致后端收到Unsupported Media Type。第三个坑是实体字段被自动填充覆盖。检查实体里有没有TableField(fill FieldFill.INSERT_UPDATE)这种注解如果有新增字段也加上同样的填充策略否则保存时createTime和updateTime会互相干扰。遇到页面提示”保存成功“但数据库只有部分字段有值优先打开后端日志把 Mapper 执行的真实 SQL 打出来。mybatis-plus: configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl开启后每次数据库操作都会打印完整 SQL 和参数比如Preparing: update patient_info SET family_doctor_no? where id?一眼就能看出漏了哪个字段。5. 上线前给社区医疗系统源码做的最小安全体检与接口验证代码能在本机跑通不代表能直接搬到线上。下载的源码在安全方面通常只剩个架子下面的检查清单按投入产出比排序每一步都能发现实际问题。5.1 扫一遍默认账号和明文密码先用一条命令扫配置和脚本里的密码痕迹grep -rniE password|pwd|secret backend/src/main/resources --include*.yml --include*.yaml --include*.properties | head -30输出结果里如果看到spring.datasource.password: 123456只能算是常规操作。重点找两类问题一是代码里写死数据库连接密码二是sys_user表初始数据里所有账号共用同一个 MD5 密码。MD5 存储的密码在现在算力下基本等于明文。处理方式是把DEFAULT 123456这种初始数据替换成 BCrypt 哈希值并在首次登录后强制改密。5.2 补上越权读取与操作日志社区医疗系统源码最常见的越权路径是这个模式登录用户拿着一个患者 ID 就能查别人档案。原因往往是 Controller 只做了“是否登录”校验没做“该用户是否有权查看该患者”。补一个最小权限判断GetMapping(/patient/{id}) public Result getPatient(PathVariable Long id, HttpServletRequest request) { Long currentUserId LoginUtil.getCurrentId(); if (!patientService.canAccess(currentUserId, id)) { auditLogService.log(deny_get_patient, request.getRemoteAddr(), id.toString()); return Result.error(403, 无权查看该档案); } auditLogService.log(get_patient, request.getRemoteAddr(), id.toString()); return Result.ok(patientService.getById(id)); }这里的核心动作是“先鉴权再查库”不是先查出患者信息再做判断。除了越权看有没有统一的操作日志入口。社区医疗涉及患者隐私谁、在什么时间、用什么 IP、对哪个患者档案做了读取或修改至少要有记录可查。手工log.info不够用最好走统一的auditLogService单独存一张审计表别人接手时也更容易知道这套系统的操作轨迹长什么样。5.3 加一个不依赖 Actuator 的 /health 接口很多从 zip 包来的源码没有引入spring-boot-starter-actuator。与其为了一个健康检查把整个监控模块带进来不如直接手写一个轻接口RestController RequestMapping(/api/health) public class HealthController { private final DataSource dataSource; public HealthController(DataSource dataSource) { this.dataSource dataSource; } GetMapping public MapString, Object check() { MapString, Object result new HashMap(); try (Connection conn dataSource.getConnection()) { result.put(status, UP); result.put(database, conn.isValid(2)); } catch (SQLException e) { result.put(status, DOWN); result.put(database, false); } return result; } }conn.isValid(2)表示在 2 秒内完成一次数据库连通性探测能真实反映系统核心依赖是否可用而不是只回一个固定的UP字符串。这个接口配合前置 Nginx 或容器编排服务的定时探测能避免“进程活着但数据库连不上”的假在线状态。返回结构保持status和database两个键后续接入监控系统时不需要改动业务代码。本文还有配套的精品资源点击获取