Spring Boot幼儿园管理系统全栈开发实战：从数据库设计到Docker部署

做过幼儿园管理系统的人都知道，这项目看着像标准的 CRUD，真做起来却相当琐碎。幼儿建档、班级调转、晨检记录、考勤打卡、收费退费、食谱公示、通知推送，每个环节都有独立的业务细节，把这些串起来的 Spring Boot 幼儿园管理系统，才是真正能落地的项目。这篇文章我会从零开始，把整个系统的设计思路、数据库建模、核心模块实现、开发环境搭建、常见坑点、Docker 部署完整过一遍，适合正在做毕业设计、自学 Spring Boot 项目实战，或者接私活做校园类管理系统的同学直接参考。

1. 项目概述与整体设计思路

1.1 幼儿园管理系统到底在解决什么问题

很多幼儿园的管理还停留在"一个班级一本 Excel、一个学期一叠纸质表"的状态。园长想统计全园出勤率，需要各班老师把表格汇总了再手工算；保健医做晨检，记录完体温、咽部情况，后续追踪全凭翻本子；财务月底催缴托费，得对着名单一个个核对谁交了谁没交。这些问题单独看都不大，堆到一起就成了管理负担。

系统要做的就是把幼儿从入园到离园的全生命周期数据管起来：入学登记、分班调班、每日打卡、晨检健康、缴费退费、食谱菜谱、公告通知、教职工权限。核心目标是让数据集中化、流程线上化、统计自动化。做这套系统的时候心里要清楚，它不是给开发人员自己用的，使用者主要是三类人：园长（看全局报表）、老师（日常录入和查看）、保健医/财务（专项操作），所以权限设计一定要分清角色。

1.2 技术选型为什么最终落在 Spring Boot

早些年这类系统常用 SSM（Spring + Spring MVC + MyBatis）手写配置，一个 XML 配置文件动辄几百行。Spring Boot 的核心价值在于自动装配和 starter 机制，把一个 Web 项目从零搭起来只需要几分钟。而且它内置 Tomcat，打包成 jar 就能跑，部署非常省心。幼儿园管理系统属于典型的单体业务系统，用户量一般不会超过几百人，并发也不高，完全不需要上微服务那套，Spring Cloud 在这里只会增加运维成本。

具体选型上，我采用的是前端 Vue3 + Element Plus 做后台管理界面，后端 Spring Boot 2.7.18 + MyBatis-Plus + MySQL 8.0，权限用 Spring Security + JWT，缓存用 Redis，文件存储用本地目录加虚拟路径映射。之所以没有用 Spring Boot 3.x，是因为很多第三方 SDK（比如短信服务、支付接口）对 JDK 1.8 的兼容性最稳定。如果你是自己学习，用 3.x + JDK 17 也没问题，但接项目尤其是接传统幼儿园的私有化部署，2.7.x + JDK 1.8 仍然是更稳妥的选择。

2. 数据库设计与核心模块拆解

2.1 整体表结构设计

数据库设计是整个系统最不该省步骤的地方。我第一版做的时候急着写代码，表结构随便建，后期改字段改到崩溃。完整的幼儿园管理系统至少需要这些表：系统用户表、角色表、菜单权限表、班级表、幼儿信息表、家长信息表、幼儿家长关联表、考勤记录表、晨检记录表、收费记录表、食谱表、公告表。如果还涉及请假审批，可以再加请假申请表。

核心关系可以简单梳理成几条线：用户和角色是多对多，角色和菜单是多对多，班级和幼儿是一对多，幼儿和家长是多对多，幼儿和考勤/晨检/收费都是一对多。关系梳理清楚之后，建表才不容易出现冗余。

2.2 关键表字段与设计细节

幼儿信息表是最核心的一张业务表，字段设计时要把常用查询条件都考虑进去。建议包含：幼儿姓名、性别、出生日期、入园日期、学籍号、班级 ID、家庭住址、过敏史、备注、逻辑删除标记、创建时间、更新时间。其中班级 ID 建普通索引，因为后面按班级查询幼儿、统计出勤率都会高频用到。

sql复制CREATE TABLE tb_child (
    id BIGINT PRIMARY KEY AUTO_INCREMENT,
    child_name VARCHAR(50) NOT NULL COMMENT '幼儿姓名',
    gender TINYINT NOT NULL COMMENT '性别 1男 2女',
    birth_date DATE COMMENT '出生日期',
    enroll_date DATE COMMENT '入园日期',
    student_no VARCHAR(30) UNIQUE COMMENT '学籍号',
    class_id BIGINT COMMENT '班级ID',
    address VARCHAR(200) COMMENT '家庭住址',
    allergy_info VARCHAR(255) COMMENT '过敏史',
    deleted TINYINT DEFAULT 0 COMMENT '逻辑删除',
    create_time DATETIME,
    update_time DATETIME
) COMMENT '幼儿信息表';

考勤表建议记录打卡人的身份类型，因为幼儿园接送场景里有"家长接送"和"亲属代接"的区别。字段包括幼儿 ID、打卡时间、打卡类型（入园/离园）、接送人姓名、接送人关系、打卡照片。每天早晚打卡后，系统按打卡时间判断是否迟到早退，这个判断逻辑放在服务层而不是数据库层，方便后续调整统计规则。

收费表需要冗余应收金额、实收金额、优惠金额、缴费状态、缴费方式、订单号。冗余的好处是统计的时候不用再关联其他表，效率高。由于幼儿园收费存在按月、按学期、按项目（托费、餐费、校车费）多种形式，所以建议加一个收费类型字段，避免后期扩展时改表结构。逻辑删除字段我基本每张表都加了，用 MyBatis-Plus 的 @TableLogic 注解处理，防止误删数据后找不回来。

2.3 MyBatis-Plus 自动填充与逻辑删除配置

每张表都有 create_time、update_time，手动 set 很容易漏。用 MyBatis-Plus 的 MetaObjectHandler 实现自动填充，实体类字段上加 @TableField(fill = FieldFill.INSERT) 和 @TableField(fill = FieldFill.INSERT_UPDATE) 注解即可。这样新增和更新时时间字段不用碰，框架自动处理。

java复制@Component
public class MyMetaObjectHandler implements MetaObjectHandler {

    @Override
    public void insertFill(MetaObject metaObject) {
        this.strictInsertFill(metaObject, "createTime", LocalDateTime.class, LocalDateTime.now());
        this.strictInsertFill(metaObject, "updateTime", LocalDateTime.class, LocalDateTime.now());
    }

    @Override
    public void updateFill(MetaObject metaObject) {
        this.strictUpdateFill(metaObject, "updateTime", LocalDateTime.class, LocalDateTime.now());
    }
}

逻辑删除的坑在于，如果查询时忘记拼接 deleted = 0 条件，会查到已删除数据；如果全局配置了逻辑删除，MyBatis-Plus 会自动在 SQL 后面拼接条件，所以普通 CRUD 不用管。但手写 SQL 的时候要特别小心，比如关联查询时如果自己写了 WHERE child_id = ?，逻辑删除条件不会自动带上，必须手动加 AND c.deleted = 0。

3. 核心功能实现与踩坑纪实

3.1 登录认证与权限控制：Spring Security + JWT

整个系统里权限这块最容易写乱。我的做法是：Spring Security 负责认证和授权框架，JWT 负责无状态 Token，用户登录成功后返回 Token，前端每次请求在 Header 里带 Authorization: Bearer <token>，后端通过过滤器解析 Token 并设置用户上下文。

由于是前后端分离，Spring Security 的配置要关掉默认的表单登录和 CSRF，放行登录接口、静态资源、以及一些无需权限的接口，其他接口全部走认证。核心过滤器是一个 JwtAuthenticationFilter，继承 OncePerRequestFilter，从请求头里拿 Token 校验，合法就把用户信息放到 SecurityContext 中。

java复制@Configuration
@EnableWebSecurity
public class SecurityConfig {

    @Bean
    public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
        http.csrf().disable()
            .sessionManagement().sessionCreationPolicy(SessionCreationPolicy.STATELESS)
            .and()
            .authorizeHttpRequests()
            .antMatchers("/api/auth/login", "/error").permitAll()
            .anyRequest().authenticated()
            .and()
            .addFilterBefore(jwtAuthenticationFilter(), UsernamePasswordAuthenticationFilter.class);
        return http.build();
    }
}

实际开发中踩过几个坑。第一，CORS 跨域配置在 Spring Security 开启后，如果只写了 WebMvcConfigurer 的跨域配置，可能不生效，必须在 SecurityFilterChain 里也配置 .cors() 并且定义 CorsConfigurationSource。第二，JWT 的密钥不能硬编码在代码里，要放配置中心或环境变量，不然每次重启都换 Token，前端会被强制下线。第三，BCrypt 加密密码，数据库中不要存明文，注册或新建用户时用 BCryptPasswordEncoder().encode(password)。

3.2 幼儿档案批量导入导出与考勤打卡

幼儿档案管理是老师使用频率最高的模块。单条新增很简单，但开园的时候几十上百个幼儿逐个录入太痛苦，所以我加了 EasyExcel 批量导入导出。导入时先读取 Excel，前端上传后后端解析，逐行校验必填字段、日期格式、性别枚举、班级是否存在，把错误行收集起来以一个汇总信息返回，方便老师修正后重新导入。

导出则相对简单，把当前班级的幼儿列表直接写入 Excel，内容包含姓名、性别、出生日期、学籍号、家长电话等，方便幼儿园留档。EasyExcel 相比 POI 的好处是内存占用低，大数据量导出不容易 OOM，而且支持模板填充。

考勤打卡的逻辑可以拆成两个接口：入园打卡和离园打卡。入园打卡时，后端获取当前打卡时间，判断是否超过幼儿园设定的入园时间（比如 8:30），超过则标记为迟到。离园打卡时，判断是否早于设定的离园时间。这里有一个容易踩的坑：时间判断不能简单用字符串比较，必须用 LocalTime 转换，而且园所的考勤规则要支持配置，不能写死在代码里。

java复制public AttendanceResult recordArrival(Long childId, Long userId) {
    LocalTime now = LocalTime.now();
    AttendanceRecord record = new AttendanceRecord();
    record.setChildId(childId);
    record.setType(1); // 1入园 2离园
    record.setTime(LocalDateTime.now());
    if (now.isAfter(configService.getArrivalDeadline())) {
        record.setStatus(2); // 迟到
    } else {
        record.setStatus(1); // 正常
    }
    attendanceMapper.insert(record);
    return new AttendanceResult(record.getStatus(), "打卡成功");
}

3.3 收费管理：批量生成账单与缴费统计

收费模块和普通 CRUD 最大的区别在于需要"批量生成"和"状态流转"。每月月底系统要根据在园幼儿的收费标准自动生成下月账单，或者财务手动勾选一批幼儿批量生成。批量生成时要注意幂等性：同一个幼儿同一个收费周期不能重复生成账单，所以建了唯一索引（child_id, charge_month, charge_type）。

缴费状态我用了枚举：待支付、已支付、已退费、已作废。前端展示时按状态筛选，财务确认收款后点击确认收款按钮，系统记录支付方式和操作人。月底统计时，按班级、按收费类型分组汇总应收、实收、欠费金额，这些统计 SQL 写起来比较绕，建议用 GROUP BY 加条件聚合，避免在 Java 里循环汇总。

java复制SELECT class_id,
       SUM(amount) AS total_amount,
       SUM(CASE WHEN status = 2 THEN amount ELSE 0 END) AS paid_amount,
       SUM(CASE WHEN status = 1 THEN amount ELSE 0 END) AS unpaid_amount
FROM tb_charge
WHERE charge_month = #{month}
GROUP BY class_id

这里有个经验：不要把金额字段设计成 DOUBLE，否则算费会出现精度问题，统一用 DECIMAL(10,2)。Java 侧对应 BigDecimal，不要用 Double 接收。

3.4 公告通知和文件上传下载

公告通知模块功能不复杂：管理员发布公告，设置置顶和有效期，发布后前端公告列表能看到。如果想做得更细致，可以加已读记录表，标记每个用户是否已读，但幼儿园场景一般不需要这么重，公告列表按时间倒序即可。如果将来要接入短信或微信公众号通知，可以抽象一个 NotifyService 接口，后续扩展不伤筋动骨。

文件上传我遇到过典型的问题：上传头像、体检报告、打卡照片，文件保存到本地磁盘后，前端访问不到。原因是没有做资源映射。Spring Boot 不会自动把磁盘目录暴露为静态资源路径。解决方法是实现 WebMvcConfigurer，把 file:D:/upload/ 映射成 /upload/** 访问路径。

java复制@Configuration
public class WebConfig implements WebMvcConfigurer {

    @Value("${file.upload-path}")
    private String uploadPath;

    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("/upload/**")
                .addResourceLocations("file:" + uploadPath + "/");
    }
}

上传文件时还应该限制文件类型和大小。Spring Boot 默认单文件上传大小是 1MB，如果上传体检报告 PDF 或者照片，需要调大配置，但也不能无限调大，否则容易被攻击。spring.servlet.multipart.max-file-size=20MB、spring.servlet.multipart.max-request-size=50MB 是我常用的配置。大文件上传如果超过 100MB，靠这个方案就不行了，需要走分片上传，这里先不展开。

4. 项目搭建与开发环境实战

4.1 从 IDEA 创建一个可运行的 Spring Boot 项目

用 IDEA 的 Spring Initializr 创建项目时，依赖不需要一次加全，加了后面也可以补。基础依赖建议：Spring Web、Spring Security、MyBatis-Plus、MySQL Driver、Redis、Lombok、Validation。创建好后第一件事就是把 application.yml 配置好，否则项目起不来。

版本选择上，我特别提醒一句：不要盲目用最新版。Spring Boot 版本太高，很多老项目依赖会冲突。比如有朋友把项目升级到 Spring Boot 3.x 之后，发现原来的 spring-boot-starter-aop 没有显式引入，结果切面不生效，日志里报找不到 AOP 类。新版本里 AOP 不再被 Web 启动器自动带入，需要手动加依赖。版本号建议以稳定线为准，2.7.x 用 JDK 1.8，3.x 用 JDK 17，两者不要混。

yaml复制server:
  port: 8080

spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://localhost:3306/kindergarten?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai
    username: root
    password: root
  data:
    redis:
      host: localhost
      port: 6379
  servlet:
    multipart:
      max-file-size: 20MB
      max-request-size: 50MB

mybatis-plus:
  global-config:
    db-config:
      logic-delete-field: deleted
      logic-delete-value: 1
      logic-not-delete-value: 0
  configuration:
    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl

jwt:
  secret: your-secret-key-change-in-prod
  expire-hours: 12

file:
  upload-path: D:/upload

4.2 单元测试与事务失效场景排查

单元测试这块刚入门的同学容易忽略，等系统上线出了问题再手动验证就晚了。我给这套系统写测试用例时，优先级是 Service 层测试大于 Controller 层测试，因为业务逻辑都沉淀在 Service 里。用 Spring Boot Test 加 H2 内存数据库测试 MyBatis 映射，可以做到不依赖外部 MySQL，跑得又快又稳定。

测试时最需要注意的是事务隔离。默认每个测试方法如果有 @Transactional，测试结束会回滚，不会污染数据库。这非常有用，但有一个大坑：@Transactional 只在方法执行期间生效，如果测试方法里手动调用了另一个同类的方法（自调用），事务会失效。这个和 Spring AOP 代理机制有关，自调用走的是 this 调用，不经过代理对象，所以切面和事务都不生效。

事务失效的真实场景，我见过这几类，整理成一张表：

单元测试示例：

java复制@SpringBootTest
@Transactional
class ChargeServiceTest {

    @Autowired
    private ChargeService chargeService;

    @Test
    void shouldGenerateMonthlyBill() {
        int count = chargeService.generateMonthlyBill("2025-07", 1L);
        assertThat(count).isGreaterThan(0);
    }
}

4.3 Spring Boot 项目持续开发中的配置技巧

项目开发过程中有几个配置建议从一开始就做好，否则后期会头疼。第一，环境配置拆分。把 application.yml 拆成 application-dev.yml、application-prod.yml，本地开发连本地库，上线用生产库，通过 spring.profiles.active=dev 切换。第二，不要把数据库密码明文写在配置文件里。至少用 Jasypt 加密，隐私要求更高的话可以对用户手机号、身份证号用 SM4 加密存储，展示时再解密，配置项用 Jasypt 加密字符串。第三，日志输出格式要包含时间、线程、类名、日志级别，方便排查线上问题。

还有一个很多人忽略的点：Spring Boot 项目如果 IDEA 中 application.yml 没有提示，通常是缺少 Spring 配置处理器依赖。在 pom.xml 中加 spring-boot-configuration-processor 即可，这个依赖只影响开发体验，不会打进部署包。

5. 常见问题排查与性能优化建议

5.1 高频报错速查表

整理一下这套系统开发过程中最常遇到的问题，以及解决思路，给后来人当个参考：

5.2 性能优化经验：缓存、索引与慢 SQL

幼儿园管理系统数据量虽然不大，但有些接口会被频繁调用，比如首页仪表盘统计、班主任查自己班的幼儿列表。如果不加缓存，每次点击都实时查库，数据库压力会随着使用人数增加而明显上升。我的优化思路是：把菜单权限、角色权限这类读多写少的数据放 Redis 缓存，登录时直接查缓存，权限变更时再清缓存。

幼儿列表查询建议加分页，MyBatis-Plus 的 Page 对象配合 IPage 很好用。分页查询时如果涉及班级名称、家长手机号等关联字段，SQL 要避免 SELECT *，只查需要的字段，同时给高频查询字段加索引。比如按班级 ID 查询幼儿，class_id 必须建索引；按学籍号查询，student_no 已经建了唯一索引。

这里还要注意慢 SQL 日志。开发环境开启 MyBatis-Plus 的 SQL 日志，上线前检查一遍，把执行慢的语句拿出来执行计划分析，重点看有没有全表扫描。很多情况下，加一个索引就能把查询时间从 300ms 降到 10ms 以内。

5.3 接口安全：API Key 对接与第三方访问控制

如果系统需要给家长端小程序或第三方平台提供接口，不能直接暴露内部接口。我建议采用 API Key 的方式：给每个第三方应用分配一个 appId 和 appSecret，调用接口时把 appId、时间戳、签名参数带给后端。后端验签通过才处理请求。签名的生成规则可以定为 MD5(appId + timestamp + appSecret)，后端用存量的 appSecret 和 appId 重新计算，相同则通过。

这种方式做起来不难，但有一个细节不要忽略：时间戳有效期校验。如果请求报文被拦截恶意重放，不校验时间戳的话，攻击者可以拿同一个请求反复调用。校验时间戳与服务器时间的差值，超过 5 分钟直接拒绝，能挡住大部分重放攻击。另外一个细节是，API Key 方案中不需要登录态的接口，要在 Spring Security 配置中额外放行，但放行前必须经过签名拦截器验证。

5.4 从单体到多园所 SaaS 的扩展方向

如果后面幼儿园连锁化了，需要多园所共用一套系统，单体架构就要考虑改造。一个比较平滑的路径是：数据层面所有表增加 tenant_id 字段做多租户隔离，MyBatis-Plus 的 TenantLineInnerInterceptor 可以自动拼接租户条件；功能层面把财务、考勤这些独立模块抽成独立服务；通信层面引入 ActiveMQ 或 RabbitMQ 处理异步通知和报表生成，而不是同步调用。工作流引擎 Flowable 也可以接入，用于请假审批、退费审批这类流程场景。

但我还是建议，如果当前园所数量不超过十个、用户量不大，不要急着拆微服务。微服务带来的分布式事务、服务治理、运维复杂度，对一个小团队来说代价相当高。先把单体应用做稳定，数据建模做合理，将来要扩展也来得及。

6. 项目部署与上线注意事项

6.1 使用 Docker 部署 Spring Boot 项目

部署上线时，最推荐的方式是 Docker。写一个 Dockerfile 把 Spring Boot 项目打包成镜像，在服务器上直接跑，再配合 docker-compose 管理 MySQL、Redis 和业务容器，环境一致性有保证，换服务器也方便。

JDK 1.8 下的 Dockerfile 示例：

dockerfile复制FROM eclipse-temurin:8-jre
LABEL maintainer="yourname"
WORKDIR /app
COPY target/kindergarten-system.jar app.jar
ENV TZ=Asia/Shanghai
RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone
EXPOSE 8080
ENTRYPOINT ["java", "-jar", "app.jar", "--spring.profiles.active=prod"]

构建好 jar 包后执行 docker build -t kindergarten-system .，然后使用 docker run 启动。如果项目里配置了 Redis 和 MySQL，建议用 docker-compose 编排，一次性启动三个容器。需要注意容器网络问题，项目容器访问 MySQL/Redis 时，地址不能再写 localhost，要写 docker-compose 里的服务名，比如 mysql:3306、redis:6379，或者在运行命令中用 --add-host host.docker.internal:host-gateway 映射宿主机地址。

部署前还有几个细节：配置文件里密码要改成环境变量注入，敏感信息不要写在 Dockerfile 或镜像里；日志目录挂载到宿主机磁盘，方便排查问题；数据库数据卷也要挂载，防止容器删除后数据丢失。

6.2 上线前检查清单与备份策略

上线前我习惯按清单过一遍，防止漏项。数据库需要检查字符集是不是 utf8mb4、表引擎是不是 InnoDB、关键表有没有索引；项目配置需要检查生产环境的 profile 是否启用、日志级别是否设置到 INFO、上传路径是否有写权限；接口层面需要确认登录接口、上传接口、统计接口是否做了合理的权限控制，密码是否加密，是否开启了 HTTPS（至少要有反向代理层做 TLS 终结）。

备份策略上，数据库用 mysqldump 做每日全量备份，保留最近 7 天；上传目录定期同步到异地磁盘或云存储。如果预算允许，建议给服务器加个简单的监控，比如磁盘空间不足时告警，避免日志或上传文件把磁盘写满导致系统假死。

我个人在这些年做管理系统项目时最深的体会是：系统性的工程问题往往不是某个技术难点，而是各种细节叠加。早早把表结构设计清楚、把配置规范定好、把事务边界划清楚，后期的麻烦会少一大半。幼儿园管理系统看着简单，真要做得让老师和园长顺手，需要站在使用者的角度反复打磨。希望这篇分享能帮你少踩一些我踩过的坑，快速把属于自己的那一版系统跑起来。