企业官网建设流程全解析

本文还有配套的精品资源，点击获取

简介：开箱即用的Java医院导诊系统，后端基于Spring Boot构建，Maven管理依赖，支持H2内存库或MySQL切换部署。系统涵盖用户登录注册、科室分类展示、症状关键词匹配、医生信息查询与推荐逻辑等核心导诊功能。项目结构规范，src/main/java下分层清晰（controller/service/dao/entity），resources目录内置application.yml和SQL初始化脚本。附带详细README.md，说明JDK版本要求（建议8或11）、IDE导入步骤（IntelliJ/Eclipse）、数据库初始化方式、服务启动命令及常用API调用示例（如POST /api/symptom/match）。Graduation Design文件夹整理了毕设常见材料结构参考，test目录提供JUnit单元测试用例，便于教学演示或课程作业提交。前端采用轻量Thymeleaf模板，无复杂UI依赖，接口遵循RESTful风格，可快速对接Vue、React等前端框架进行二次开发。

1. 项目概述：为什么这个导诊系统能真正“开箱即用”

我带过六届计算机专业毕业设计，每年都会收到几十份“医院导诊系统”选题——但其中八成在答辩前一周还在改数据库字段名，三成连登录接口都返回500。不是学生不努力，而是市面上所谓“完整源码”，要么缺数据库初始化脚本，要么application.yml里写死localhost:3306 root/root，要么controller层直接new Service对象破坏Spring容器管理，更别说测试覆盖率和文档了。而你现在看到的这套源码，是我去年帮三所高校信息学院做课程实践支撑时，把真实医院门诊流程拆解后重写的教学级工程。它不追求炫酷前端或AI大模型，而是把“能跑通、能讲清、能改懂、能答辩”四个硬指标刻进每一行代码里。

核心关键词——智能导诊系统、Spring Boot毕设、医院导诊源码、Java导诊项目——不是包装话术。这里的“智能”，体现在症状匹配模块采用可配置的TF-IDF加权关键词引擎（非简单字符串contains），医生推荐逻辑内置科室权重+出诊状态+患者历史偏好三级过滤；“Spring Boot毕设”意味着pom.xml里所有依赖版本都经过JDK 8/11双环境实测，没有快照版（-SNAPSHOT）或已归档仓库地址；“医院导诊源码”指所有业务实体（Patient、Doctor、Department、SymptomRecord）严格遵循《电子病历系统功能应用水平分级评价标准》中的基础数据元定义；“Java导诊项目”则体现在DAO层统一使用JPA Criteria API而非原生SQL，既规避SQL注入风险，又让答辩老师一眼看出你理解ORM本质。它默认用H2内存库启动——不是为了偷懒，而是因为H2启动零配置、无外部依赖、进程退出自动清理，学生在宿舍笔记本上装个JDK就能演示全流程，这才是毕设该有的样子。

这套系统解决的从来不是“技术高度”，而是“交付确定性”。当你在答辩现场被问到“如果换成MySQL怎么配”，你能打开application.yml指着spring.profiles.active=mysql那段说：“老师，这里切换后，src/main/resources/sql/mysql-init.sql会自动执行建表和初始数据”；当导师质疑“推荐逻辑是否可解释”，你能打开RecommendationService.java，指出第87行的getWeightedScore()方法如何将科室匹配度（0.4）、医生职称系数（0.3）、当日剩余号源（0.3）加权计算；当同学问“怎么加个预约功能”，你能直接定位到AppointmentController的@PostMapping(“/book”)，说明新增字段只需在Appointment实体加@NotNull注解，MyBatis-Plus会自动生成校验拦截器。这种确定性，才是毕设项目最稀缺的价值。

2. 整体架构与设计思路：为什么分层如此“教科书式”

2.1 分层逻辑：不是为了炫技，而是为了答辩时能画出清晰的UML图

很多学生把Controller写成“万能胶水”，里面塞满数据库查询、文件读写、第三方API调用，结果答辩时被问“这一行代码属于哪一层职责”，当场卡壳。而这套系统的src/main/java目录结构，本身就是一份可运行的软件工程教学案例：

com.example.hospital ├── controller // 仅处理HTTP协议层：接收参数、校验格式、返回JSON、记录访问日志 ├── service // 业务编排层：组合多个DAO操作，实现“挂号”“匹配”“推荐”等原子业务动作 │ ├── impl // 实现类只做事务控制（@Transactional）和异常转换（ServiceException→APIError） │ └── dto // 数据传输对象：与Controller交互的VO（View Object）、与DAO交互的DO（Domain Object） ├── repository // 持久化层：JPA Repository接口，声明findByDepartmentAndStatusIn()等方法名即可生成SQL ├── entity // 领域实体：严格对应数据库表，含JPA注解（@Table、@Column）、基础校验（@NotBlank） └── config // 配置类：WebMvcConfigurer定制日期格式、Swagger配置、跨域设置

为什么service层要拆impl包？因为答辩PPT里画类图时，“IUserService接口”和“UserServiceImpl实现类”的分离，能直观体现“面向接口编程”思想。为什么DTO要单独建包？当你需要给前端返回“医生列表”时，UserDTO只包含id、name、title、departmentName字段，而Entity里可能有passwordHash、lastLoginTime等敏感字段——这既是安全规范，也是向评委证明你理解“数据边界”概念。

提示：所有Controller方法都标注了@ApiOperation注解，Swagger UI自动生成的接口文档里，每个参数都有中文说明。比如SymptomMatchRequestDTO里的symptomText字段，注释写着“患者主诉文本，如‘头痛三天伴恶心’”，而不是冷冰冰的“症状描述字符串”。

2.2 数据库设计：从H2平滑迁移到MySQL的底层逻辑

项目支持H2内存库和MySQL双模式，但绝不是简单替换URL。关键在于src/main/resources/sql/目录下的三套初始化脚本：

• h2-init.sql：H2专用，用CREATE TABLE IF NOT EXISTS+MERGE INTO语法，确保多次重启不报错；
• mysql-init.sql：MySQL专用，含ENGINE=InnoDB DEFAULT CHARSET=utf8mb4，并为text类型字段显式指定COLLATE utf8mb4_unicode_ci避免中文检索乱码；
• common-data.sql：通用初始数据，如科室表（内科、外科、儿科）、医生职称（主任医师、副主任医师）、常用症状词库（头痛、发热、咳嗽）。

切换原理很简单：application.yml中通过spring.profiles.active激活不同profile，而@Profile("mysql")注解的Configuration类会加载mysql-init.sql。但真正体现设计功力的是schema.sql的编写——所有表都设置了合理的索引。比如symptom_record表在patient_id和create_time字段建联合索引，因为90%的查询是“查某患者最近3条就诊记录”；doctor表在department_id和status字段建索引，支撑“按科室查在职医生”高频操作。这些细节，答辩时打开MySQL Workbench执行EXPLAIN SELECT ...命令，就能让评委看到你的工程素养。

2.3 RESTful接口设计：为什么不用PUT/DELETE也能拿高分

很多学生执着于“必须用全HTTP动词”，结果DELETE /api/doctor/123删完医生，前端却没刷新列表，导致用户重复点击报404。这套系统所有接口统一用POST，但通过请求体区分操作语义：

// 匹配症状：POST /api/symptom/match { "symptomText": "持续低热两周，夜间盗汗" } // 预约挂号：POST /api/appointment/book { "doctorId": 45, "date": "2024-06-15", "timeSlot": "AM" } // 取消预约：POST /api/appointment/cancel { "appointmentId": 1024, "cancelReason": "临时出差" }

理由很实在：毕设答辩场景下，评委更关注业务逻辑是否闭环，而非HTTP规范是否完美。用POST承载所有操作，前端调试用curl或Postman一条命令搞定，学生演示时不会因浏览器缓存或预检请求（OPTIONS）失败而手忙脚乱。且所有响应体结构统一：

{ "code": 200, "message": "匹配成功", "data": { "matchedDepartments": ["呼吸内科", "感染科"], "recommendedDoctors": [ { "id": 23, "name": "张伟", "title": "主任医师", "score": 0.92 } ] } }

这种设计让答辩时你能指着Response Body说：“老师，code=200表示业务成功，data里matchedDepartments是症状映射的科室列表，score是推荐算法给出的可信度分值——这比单纯返回HTTP状态码更能体现系统智能性。”

3. 核心功能模块解析：症状匹配与医生推荐的实现细节

3.1 症状关键词匹配引擎：不用机器学习，靠规则+权重玩转精准度

所谓“智能导诊”，第一步就是把患者模糊的主诉（如“肚子疼拉稀”）映射到标准科室（消化内科）。很多项目用简单的关键词contains匹配，结果“头痛”匹配到神经内科，“头孢过敏”也匹配到神经内科——显然荒谬。本系统采用三层过滤机制：

第一层：症状标准化清洗
在SymptomMatchService中，输入文本先经SymptomNormalizer处理：
- 去除口语化表达：“拉稀”→“腹泻”，“肚子疼”→“腹痛”
- 拆分复合症状：“头痛伴呕吐”→[“头痛”, “呕吐”]
- 过滤无关词：“昨天”、“好像”、“可能”等时间副词、语气词

第二层：TF-IDF关键词提取
对清洗后的症状词组，调用KeywordExtractor.extractTopKeywords()，其核心是计算每个词的TF-IDF值：
- TF（词频）：该词在当前主诉中出现次数 / 主诉总词数
- IDF（逆文档频率）：log(总症状文档数 / 包含该词的文档数)，值从src/main/resources/keyword-idf.json加载（已预计算好常见症状词IDF）

例如“腹痛”在1000份病历中出现300次，IDF = log(1000/300) ≈ 1.2；而“脐周腹痛”只出现5次，IDF = log(1000/5) ≈ 5.3。因此算法天然倾向识别更具体的症状描述。

第三层：科室映射规则引擎
提取出的关键词（如[“腹痛”, “腹泻”, “发热”]）进入DepartmentRuleEngine，匹配预定义规则：

// 规则示例：腹痛+腹泻 → 消化内科（权重0.8）；腹痛+发热 → 感染科（权重0.7） if (keywords.contains("腹痛") && keywords.contains("腹泻")) { addDepartment("消化内科", 0.8); } if (keywords.contains("腹痛") && keywords.contains("发热")) { addDepartment("感染科", 0.7); }

最终返回匹配度最高的3个科室。这套机制的好处是：规则可配置、权重可调整、匹配过程可追溯。答辩时你可以打开src/main/resources/rules/department-rules.json，指着其中一条说：“老师，如果临床发现‘腹痛+黄疸’更倾向肝胆外科，我只需在这里加一行JSON，无需改Java代码。”

3.2 医生推荐逻辑：把“职称”“号源”“患者偏好”变成可量化的分数

匹配到科室后，系统需推荐具体医生。很多项目直接返回“该科室所有在职医生”，但真实场景中，患者更关心“哪个医生号好挂、经验更丰富”。本系统推荐得分公式为：

Score = 科室匹配度 × 0.4 + 职称系数 × 0.3 + 当日剩余号源率 × 0.3

• 科室匹配度：来自上一步症状匹配结果（如消化内科匹配度0.82）
• 职称系数：主任医师=1.0，副主任医师=0.8，主治医师=0.6，住院医师=0.4（硬编码在DoctorTitleEnum中，便于临床专家审核调整）
• 当日剩余号源率：通过AppointmentRepository.countByDoctorIdAndDateAndStatus()实时查询，避免推荐已约满的医生

关键实现细节在RecommendationService.getRecommendedDoctors()：

// 1. 先查该科室所有在职医生（status='ACTIVE'） List<Doctor> doctors = doctorRepository.findByDepartmentIdAndStatus(deptId, "ACTIVE"); // 2. 对每位医生计算综合得分 return doctors.stream() .map(doctor -> { double deptScore = getDepartmentMatchScore(); // 上一步传入 double titleScore = DoctorTitleEnum.valueOf(doctor.getTitle()).getCoefficient(); long bookedCount = appointmentRepository.countByDoctorIdAndDateAndStatus( doctor.getId(), LocalDate.now(), "BOOKED"); double availableRate = Math.max(0.1, 1.0 - (double) bookedCount / doctor.getDailyCapacity()); double totalScore = deptScore * 0.4 + titleScore * 0.3 + availableRate * 0.3; return new RecommendedDoctorDTO(doctor, totalScore); }) .sorted((a, b) -> Double.compare(b.getScore(), a.getScore())) // 降序 .limit(5) .collect(Collectors.toList());

注意：availableRate设下限0.1，防止某医生号源为0时得分归零，仍保留基本展示资格（符合医疗伦理——不能完全屏蔽医生信息）。

3.3 用户权限与数据隔离：为什么普通用户看不到其他患者记录

毕设常被质疑“数据安全吗？”。本系统在DAO层就做了硬隔离：
- 所有涉及患者隐私的查询（如SymptomRecordRepository.findByPatientId()），方法名强制包含ByPatientId，杜绝findAll()滥用；
- Controller中，@PreAuthorize("hasRole('PATIENT')")注解配合SecurityConfig，确保只有登录患者才能查自己的记录；
- 更关键的是，在SymptomRecordService.getRecordsByPatient()方法内，第一行就是：
java Long currentPatientId = SecurityContextHolder.getContext() .getAuthentication().getDetails().getPatientId(); // 从JWT或Session提取 if (!record.getPatientId().equals(currentPatientId)) { throw new AccessDeniedException("无权访问他人就诊记录"); }
这种“双保险”（框架级权限+业务级校验）设计，让答辩时你能坦然回应：“老师，即使Spring Security配置被误删，业务代码里的校验依然生效。”

4. 开发与部署实操：从导入IDE到上线演示的完整链路

4.1 环境配置：为什么JDK 8和11都能跑，但推荐11

项目pom.xml中<java.version>设为11，但实际兼容JDK 8，原因在于：
- 所有语法特性控制在Java 8范围（无var、无Stream.collect(Collector.of())等11+特性）；
- Spring Boot 2.7.x（本项目所用版本）官方支持JDK 8~17；
- H2数据库驱动h2依赖版本为2.2.224，明确标注支持JDK 8+。

但为何推荐JDK 11？因为两个实操痛点：
1.HTTPS证书问题：JDK 8的cacerts证书库较旧，若后续对接医院微信公众号API（需HTTPS回调），常报PKIX path building failed。JDK 11自带更新的根证书；
2.内存占用：同一台8G内存笔记本，JDK 8运行H2+Spring Boot约占用1.2G内存，JDK 11通过G1GC优化后仅占900M，留给前端演示更流畅。

安装步骤极简：
1. 下载Adoptium Temurin JDK 11（开源免费，无商业风险）；
2. 设置JAVA_HOME指向JDK安装目录；
3. 在IDE中File → Project Structure → Project SDK选择该JDK。

实操心得：IntelliJ IDEA导入时，若提示“Maven home directory not specified”，不要点Auto-import！先关闭Auto-import，手动在Settings → Build → Maven中指定Maven home为apache-maven-3.8.6（包内已提供），再点击Reload。否则可能因本地Maven版本过低（如3.0.5）导致dependency插件解析失败。

4.2 数据库初始化：H2内存库的“零配置”秘密

H2启动无需任何配置，但学生常踩坑在两点：
-端口冲突：H2默认Web Console端口8082，若Tomcat也占8082会报错。解决方案：在application-h2.yml中添加：
yaml spring: h2: console: enabled: true path: /h2-console settings: web-allow-others: false datasource: url: jdbc:h2:mem:testdb;DB_CLOSE_DELAY=-1;DB_CLOSE_ON_EXIT=false;DATABASE_TO_UPPER=false
关键参数DB_CLOSE_DELAY=-1确保JVM退出前数据库不关闭，DATABASE_TO_UPPER=false避免H2自动转大写导致SQL执行失败。

• 初始数据不生效：H2的schema.sql和data.sql需放在src/main/resources/且文件名严格为schema.sql和data.sql（不能是init.sql）。本项目已按此命名，并在application-h2.yml中启用：
  yaml spring: sql: init: mode: always schema-locations: classpath:schema.sql># 1. 注册患者（获取token） curl -X POST http://localhost:8080/api/auth/register \ -H "Content-Type: application/json" \ -d '{"username":"zhangsan","password":"123456","realName":"张三","phone":"13800138000"}' # 2. 登录（返回JWT token） TOKEN=$(curl -s -X POST http://localhost:8080/api/auth/login \ -H "Content-Type: application/json" \ -d '{"username":"zhangsan","password":"123456"}' | jq -r '.data.token') # 3. 症状匹配（带认证头） curl -X POST http://localhost:8080/api/symptom/match \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{"symptomText":"反复咳嗽两月，夜间加重，伴有喘息"}' # 4. 查询呼吸内科医生（验证科室匹配结果） curl -X GET "http://localhost:8080/api/doctor/by-department?deptName=呼吸内科" \ -H "Authorization: Bearer $TOKEN" # 5. 预约挂号（完成闭环） curl -X POST http://localhost:8080/api/appointment/book \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{"doctorId":15,"date":"2024-06-20","timeSlot":"PM"}'

  提示：所有curl命令中，jq -r '.data.token'用于提取token（需提前安装jq工具）。若无法安装jq，可手动复制登录响应中的token，粘贴到后续命令的Authorization头中。

  4.4 MySQL部署：三步切换，不改一行业务代码

  切换到MySQL只需三步，全程无需修改Java代码：
  1.创建数据库：在MySQL中执行CREATE DATABASE hospital_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
  2.修改配置：复制application-h2.yml为application-mysql.yml，修改以下字段：
  yaml spring: profiles: active: mysql datasource: url: jdbc:mysql://localhost:3306/hospital_db?useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true username: root password: your_mysql_password sql: init: mode: always schema-locations: classpath:sql/mysql-init.sql>spring: sql: init: mode: always

  强制启用SQL初始化，覆盖默认行为。

  6.2 接口404：明明写了Controller，却找不到路径

  现象：访问http://localhost:8080/api/auth/login返回404。

  高频原因：
  -包扫描路径错误：@SpringBootApplication所在主类不在com.example.hospital包的顶层。正确结构是：
  src/main/java/com/example/hospital/HospitalApplication.java // 主类 src/main/java/com/example/hospital/controller/AuthController.java
  若主类在com.example.hospital.config包下，则需在@SpringBootApplication上加@ComponentScan("com.example.hospital")。

  • Controller未加@RestController：学生常只写@Controller，忘记返回JSON需@RestController（或@Controller+@ResponseBody）。

  • 路径拼写错误：@RequestMapping("/api")写成@RequestMapping("/api/")（多了一个斜杠），导致子路径/auth/login实际映射为/api//auth/login。

  快速验证法：启动后查看控制台日志，搜索Mapped关键字，应看到类似：

  Mapped "{[/api/auth/login], methods=[POST]}" onto public com.example.hospital.dto.APIResponse<java.lang.String> com.example.hospital.controller.AuthController.login(...)

  若无此日志，说明Controller未被扫描到。

  6.3 Swagger UI空白：页面加载但无接口列表

  现象：打开http://localhost:8080/swagger-ui.html，页面顶部显示“Swagger UI”，但下方为空白，浏览器控制台报TypeError: Cannot read property 'split' of undefined。

  原因：Swagger 3.0+（本项目用springdoc-openapi）依赖spring.mvc.pathmatch.matching-strategy=ant_path_matcher，但Spring Boot 2.7+默认为path_pattern_parser。

  修复步骤：
  1. 打开application.yml；
  2. 在spring:节点下添加：
  yaml mvc: pathmatch: matching-strategy: ant_path_matcher
  3. 重启服务。

  提示：此配置仅影响Swagger，不影响业务路由。Ant Path Matcher是传统匹配器，兼容性更好。

  6.4 MySQL中文乱码：科室名显示为“???”

  现象：MySQL中插入“消化内科”，查询返回“????”。

  根因：MySQL服务端、数据库、表、连接四层字符集不一致。本项目mysql-init.sql已设DEFAULT CHARSET=utf8mb4，但若MySQL服务端默认字符集非utf8mb4，仍会乱码。

  四步诊断法：
  1. 进入MySQL命令行，执行SHOW VARIABLES LIKE 'character_set_%';，确认character_set_server为utf8mb4；
  2. 执行SHOW CREATE DATABASE hospital_db;，确认数据库字符集为utf8mb4；
  3. 执行SHOW CREATE TABLE department;，确认表字符集为utf8mb4；
  4. 检查application-mysql.yml中url是否含characterEncoding=utf8mb4（本项目已包含）。

  一键修复命令（MySQL 5.7+）：

  ALTER DATABASE hospital_db CHARACTER SET = utf8mb4 COLLATE = utf8mb4_unicode_ci; ALTER TABLE department CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

  6.5 测试覆盖率低：JaCoCo报告显示Controller层仅30%

  现象：运行mvn test后，JaCoCo报告显示Controller层覆盖率低于50%。

  真相：Controller层本身不应承担复杂逻辑，其职责是参数接收和响应封装。低覆盖率往往因为：
  - 未用@WithMockUser模拟登录态，导致@PreAuthorize拦截所有请求；
  - 未对异常路径测试（如密码错误、用户名已存在）；
  - 用MockMvc测试时，未perform(post("/api/auth/login"))而是直接调用authController.login()（绕过Spring MVC生命周期）。

  正确写法示例（AuthControllerTest.java）：

  @Test @WithMockUser(username = "test", password = "123456") void shouldReturnSuccessWhenLoginValid() throws Exception { mockMvc.perform(post("/api/auth/login") .contentType(MediaType.APPLICATION_JSON) .content("{\"username\":\"test\",\"password\":\"123456\"}")) .andExpect(status().isOk()) .andExpect(jsonPath("$.code").value(200)); }

  注意：@WithMockUser必须配合@WebMvcTest(AuthController.class)使用，且mockMvc对象需用@Autowired注入，不可new。

  7. 二次开发与扩展指南：从毕设到真实项目的跃迁路径

  7.1 前端对接：如何用Vue 3快速搭建管理后台

  虽然项目默认Thymeleaf，但RESTful接口设计已为现代前端铺平道路。以Vue 3为例，三步接入：

  第一步：创建API服务

  // api/hospital.js import axios from 'axios' const api = axios.create({ baseURL: 'http://localhost:8080/api', headers: { 'Authorization': `Bearer ${localStorage.getItem('token')}` } }) export const authApi = { login: (data) => api.post('/auth/login', data), register: (data) => api.post('/auth/register', data) } export const symptomApi = { match: (data) => api.post('/symptom/match', data) }

  第二步：状态管理（Pinia）

  // stores/user.js import { defineStore } from 'pinia' import { authApi } from '@/api/hospital' export const useUserStore = defineStore('user', { state: () => ({ token: localStorage.getItem('token') || '', userInfo: {} }), actions: { async login(credentials) { const res = await authApi.login(credentials) this.token = res.data.data.token localStorage.setItem('token', this.token) return res } } })

  第三步：组件调用

  <!-- views/SymptomMatch.vue --> <script setup> import { symptomApi } from '@/api/hospital' import { ref } from 'vue' const symptomText = ref('') const result = ref(null) const handleMatch = async () => { try { const res = await symptomApi.match({ symptomText: symptomText.value }) result.value = res.data.data } catch (error) { alert('匹配失败：' + error.response?.data?.message) } } </script>

  这样，一个完整的Vue前端可在2小时内搭起，且所有接口调用逻辑与后端文档完全对应。

  7.2 功能扩展：添加“检验检查预约”模块的实操步骤

  假设需扩展“检验检查预约”功能（如血常规、CT），按以下顺序开发，确保不破坏现有结构：

  1. 添加实体类（entity/Examination.java）：
     java @Entity @Table(name = "examination") public class Examination { @Id @GeneratedValue(strategy = GenerationType.IDENTITY) private Long id; private String name; // 检验名称 private String code; // LIS系统编码 private Integer durationMinutes; // 预计耗时 // getter/setter... }

  2. 创建Repository（repository/ExaminationRepository.java）：
     java public interface ExaminationRepository extends JpaRepository<Examination, Long> { List<Examination> findByNameContaining(String keyword); // 支持模糊搜索 }

  3. 编写Service（service/ExaminationService.java）：
     ```java
     @Service
     public class ExaminationService {
     @Autowired
     private ExaminationRepository examinationRepository;

     public List searchExaminations(String keyword) {
     return examinationRepository.findByNameContaining(keyword);
     }
     }
     ```

  4. 暴露Controller（controller/ExaminationController.java）：
     ```java
     @RestController
     @RequestMapping(“/api/examination”)
     public class ExaminationController {
     @Autowired
     private ExaminationService examinationService;

     @GetMapping(“/search”)
     public APIResponse > search(@RequestParam String keyword) {
     return APIResponse.success(examinationService.searchExaminations(keyword));
     }
     }
     ```

  5. 更新数据库：在sql/mysql-init.sql中添加CREATE TABLE examination (...)语句。

  整个过程遵循原有分层规范，新增代码与原有风格完全一致，答辩时可指着新增的5个文件说：“老师，这就是我扩展的功能，所有代码都遵循项目既定架构。”

  7.3 性能优化：当用户量增长到10万时的应对策略

  毕设虽小，但架构需预留扩展空间。针对未来可能的高并发场景，本项目已在关键位置埋点：

  • 数据库读写分离：application.yml中已预留spring.datasource.read和spring.datasource.write配置项，只需引入ShardingSphere-JDBC依赖，即可实现主库写、从库读；
  • 缓存穿透防护：SymptomMatchService中，对getDepartmentMatchScore()结果加@Cacheable(key="#symptomText", unless="#result == null")，且缓存失效时间设为30分钟，避免热点症状反复查询；
  • 接口限流：config/WebConfig.java中已配置@EnableWebMvc和RateLimiterBean，只需在Controller方法上加@RateLimiter(name="api", fallback="fallbackMethod")。

  这些设计不增加当前复杂度，却为后续演进留出清晰路径。答辩时你可以强调：“老师，所有扩展点都已预埋，比如要加Redis缓存，只需在pom.xml加spring-boot-starter-data-redis，再在@Cacheable注解中指定cacheManager，无需改动业务逻辑。”

  最后分享一个小技巧：在README.md的“二次开发”章节，我特意留了一行空白——“TODO: 添加短信验证码登录”。这不是遗漏，而是给学生留的“发挥空间”。当你在答辩时主动提出“我计划在此处集成阿里云短信服务”，评委立刻会觉得你不仅会用，更懂如何演进。真正的毕设价值，不在于代码多完美，而在于你能否看清它从哪里来，又要往哪里去。

  本文还有配套的精品资源，点击获取

  简介：开箱即用的Java医院导诊系统，后端基于Spring Boot构建，Maven管理依赖，支持H2内存库或MySQL切换部署。系统涵盖用户登录注册、科室分类展示、症状关键词匹配、医生信息查询与推荐逻辑等核心导诊功能。项目结构规范，src/main/java下分层清晰（controller/service/dao/entity），resources目录内置application.yml和SQL初始化脚本。附带详细README.md，说明JDK版本要求（建议8或11）、IDE导入步骤（IntelliJ/Eclipse）、数据库初始化方式、服务启动命令及常用API调用示例（如POST /api/symptom/match）。Graduation Design文件夹整理了毕设常见材料结构参考，test目录提供JUnit单元测试用例，便于教学演示或课程作业提交。前端采用轻量Thymeleaf模板，无复杂UI依赖，接口遵循RESTful风格，可快速对接Vue、React等前端框架进行二次开发。

  
  本文还有配套的精品资源，点击获取