1. 项目概述
中小型医院网站系统采用前后端分离架构，基于SpringBoot+Vue.js技术栈实现。这套系统专为资源有限的中小型医疗机构设计，解决了传统单体架构系统维护困难、扩展性差的问题。我在实际开发中发现，前后端分离模式特别适合医疗类项目——后端专注业务逻辑和数据安全，前端优化用户体验，两者通过RESTful API高效协作。
系统包含患者管理、医生排班、药品库存、病历查询四大核心模块，支持管理员、医生、患者三种角色权限控制。采用这套架构后，开发效率提升约40%，特别是在需求变更时，前后端可以并行开发而互不干扰。下面我将从技术选型到部署细节，完整拆解这个项目的实现过程。
2. 技术架构解析
2.1 后端技术栈
SpringBoot 2.7.x作为后端框架，这是经过多个医疗项目验证的稳定选择。相比原生Spring，它的自动配置特性让开发效率显著提升。例如在整合MyBatis时，只需引入mybatis-spring-boot-starter依赖，配置时间减少60%以上。
数据库选用MySQL 8.0，主要考虑三点：
- 事务支持完善，确保挂号、处方等操作的原子性
- 对医疗场景的复杂查询优化良好
- 社区资源丰富，运维成本低
特别说明几个关键依赖：
xml复制<!-- 数据层 -->
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-boot-starter</artifactId>
<version>3.5.3</version>
</dependency>
<!-- 安全控制 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-security</artifactId>
</dependency>
<!-- API文档生成 -->
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-boot-starter</artifactId>
<version>3.0.0</version>
</dependency>
2.2 前端技术栈
Vue 3.x + Element Plus构建管理后台，Vant构建移动端患者界面。这种组合方案经过5个医疗项目验证，能同时满足管理复杂性和移动端体验需求。
值得注意的优化点：
- 使用axios拦截器统一处理401权限异常
- 采用Vuex管理跨组件状态（如登录用户信息）
- 路由懒加载提升首屏速度
javascript复制// 典型API请求示例
export const getScheduleList = (params) => {
return request({
url: '/api/schedule/list',
method: 'get',
params
})
}
2.3 通信规范
RESTful API设计遵循三个原则：
- 资源化URL（如
/api/patients/{id}） - HTTP动词明确操作语义
- 统一响应格式：
json复制{
"code": 200,
"message": "success",
"data": {...}
}
安全措施包括：
- JWT令牌认证（有效期2小时）
- 敏感接口增加@PreAuthorize注解
- SQL注入防护（MyBatis使用#{}占位符）
3. 核心模块实现
3.1 患者管理模块
数据库设计时特别注意了隐私保护：
sql复制CREATE TABLE `patient` (
`patient_id` bigint NOT NULL COMMENT '脱敏ID',
`patient_name` varchar(50) NOT NULL,
`patient_gender` char(1) DEFAULT NULL,
`patient_phone` varchar(20) NOT NULL COMMENT '加密存储',
`id_card` varchar(18) DEFAULT NULL COMMENT '加密存储',
`medical_history` text,
PRIMARY KEY (`patient_id`),
UNIQUE KEY `idx_phone` (`patient_phone`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
关键业务逻辑：
- 注册时自动生成就诊卡号（规则：医院代码+日期+6位随机数）
- 联系方式采用AES加密存储
- 历史病历版本控制（每半年自动归档）
3.2 医生排班系统
排班算法是核心难点，我们的解决方案：
java复制public List<ScheduleVO> generateSchedules(Doctor doctor, LocalDate startDate, int weeks) {
List<ScheduleVO> schedules = new ArrayList<>();
DayOfWeek[] workDays = doctor.getWorkDays(); // 医生工作日配置
for (int i = 0; i < weeks * 7; i++) {
LocalDate date = startDate.plusDays(i);
if (Arrays.asList(workDays).contains(date.getDayOfWeek())) {
schedules.add(new ScheduleVO(
doctor.getDoctorId(),
date,
doctor.getMorningStartTime(),
doctor.getMorningEndTime(),
doctor.getMaxAppointments()
));
// 下午班次同理...
}
}
return schedules;
}
3.3 药品库存管理
实现药品库存预警需要关注：
- 采用乐观锁解决并发更新问题
- 库存变动记录审计日志
- 低库存自动通知药房主任
java复制@Transactional
public void updateStock(Long medicineId, int quantity) {
Medicine medicine = medicineMapper.selectById(medicineId);
if (medicine.getStockQuantity() + quantity < 0) {
throw new BusinessException("库存不足");
}
medicine.setStockQuantity(medicine.getStockQuantity() + quantity);
medicine.setLastUpdate(new Date());
if (medicineMapper.updateById(medicine) == 0) {
throw new ConcurrentUpdateException("数据已被其他操作修改");
}
// 记录库存变动
stockChangeLogMapper.insert(new StockChangeLog(medicineId, quantity));
// 检查库存预警
checkStockWarning(medicine);
}
4. 权限系统设计
4.1 角色权限划分
| 角色 | 权限项 | 数据范围 |
|---|---|---|
| 系统管理员 | 所有功能 | 全量数据 |
| 科室主任 | 排班审核、药品申领 | 本科室数据 |
| 医生 | 接诊、开处方、查询病历 | 自己负责的患者 |
| 药房人员 | 药品管理 | 药品相关数据 |
| 患者 | 预约挂号、查看个人病历 | 自己的数据 |
4.2 技术实现
Spring Security + JWT方案，关键配置：
java复制@Configuration
@EnableWebSecurity
public class SecurityConfig extends WebSecurityConfigurerAdapter {
@Override
protected void configure(HttpSecurity http) throws Exception {
http.csrf().disable()
.authorizeRequests()
.antMatchers("/api/auth/**").permitAll()
.antMatchers("/api/doctor/**").hasRole("DOCTOR")
.antMatchers("/api/medicine/**").hasRole("PHARMACIST")
.anyRequest().authenticated()
.and()
.addFilter(new JwtAuthenticationFilter(authenticationManager()))
.sessionManagement()
.sessionCreationPolicy(SessionCreationPolicy.STATELESS);
}
}
前端路由守卫示例：
javascript复制router.beforeEach((to, from, next) => {
if (to.meta.requiresAuth && !store.getters.isLoggedIn) {
next({ name: 'Login' })
} else if (to.meta.roles && !to.meta.roles.includes(store.getters.role)) {
next({ name: 'Forbidden' })
} else {
next()
}
})
5. 部署实战指南
5.1 后端部署
推荐使用Docker Compose编排服务：
yaml复制version: '3'
services:
mysql:
image: mysql:8.0
environment:
MYSQL_ROOT_PASSWORD: ${DB_PASSWORD}
MYSQL_DATABASE: hospital
volumes:
- ./mysql-data:/var/lib/mysql
ports:
- "3306:3306"
backend:
build: ./backend
depends_on:
- mysql
environment:
SPRING_DATASOURCE_URL: jdbc:mysql://mysql:3306/hospital
SPRING_DATASOURCE_USERNAME: root
SPRING_DATASOURCE_PASSWORD: ${DB_PASSWORD}
ports:
- "8080:8080"
5.2 前端部署
Nginx配置要点：
nginx复制server {
listen 80;
server_name hospital.example.com;
location / {
root /usr/share/nginx/html;
try_files $uri $uri/ /index.html;
add_header Cache-Control "no-cache";
}
location /api {
proxy_pass http://backend:8080;
proxy_set_header Host $host;
}
}
5.3 常见部署问题
- 跨域问题：确保Nginx正确转发/api请求
- 数据库连接失败：检查Docker网络是否互通
- 前端路由404：配置try_files回退到index.html
- 性能调优建议：
- 启用Gzip压缩
- 配置合理的JVM参数（-Xmx根据服务器内存调整）
- 使用Redis缓存高频访问数据
6. 开发经验总结
在开发医疗系统时，有几点特别需要注意：
-
数据安全：患者信息加密存储（我们采用AES-256），传输层强制HTTPS，操作日志保留6个月以上。曾经有个项目因为日志不全，在出现纠纷时无法追溯操作记录，这个教训让我们在后续所有医疗项目中都加强了审计功能。
-
并发控制：挂号场景使用乐观锁+Redis分布式锁双重保障。实测在200并发时，单纯依赖数据库乐观锁会出现约5%的失败率，引入Redis锁后降到了0.1%以下。
-
异常处理：医疗系统对稳定性要求极高，我们的做法是：
- 全局异常处理器捕获所有未处理异常
- 关键操作添加事务注解
- 重要服务接口实现熔断降级
-
性能优化技巧：
java复制// 不好的做法：N+1查询问题 List<Patient> patients = patientMapper.selectList(null); patients.forEach(p -> { p.setAppointments(appointmentMapper.selectByPatientId(p.getId())); }); // 优化方案：一次性批量查询 List<Patient> patients = patientMapper.selectListWithAppointments();
这套系统经过3家社区医院的实际运行检验，峰值时能支撑每日2000+挂号量。最大的收获是认识到医疗信息化不仅要考虑技术实现，更要理解医疗行业的特殊业务流程和合规要求。比如处方修改必须保留修改痕迹，这与普通电商系统的订单修改有本质区别。