东予薏米1. 鲜牛奶订购系统的商业背景与技术选型
在生鲜食品电商领域，鲜奶制品因其特殊的保鲜需求一直是个技术难点。传统线下订购方式存在配送不及时、库存管理混乱等问题，而普通电商系统又难以满足鲜奶产品的周期性订购、冷链配送等特殊需求。这正是我们选择开发专门鲜牛奶订购系统的原因。
SpringBoot作为当前Java领域最流行的微服务框架，其快速启动、约定优于配置的特性非常适合此类中小型垂直电商系统的开发。我在实际选型中主要考虑了以下技术组合：
- 核心框架：SpringBoot 2.7.0（长期支持版本）
- 数据持久层：MyBatis-Plus 3.5.17（配套版本）
- 分页插件：PageHelper
- 前端架构：Vue.js 3（前后端分离）
- 消息队列：ActiveMQ（用于订单状态通知）
- 部署方案：Docker容器化
特别提示：MyBatis-Plus版本必须与SpringBoot版本严格匹配，否则会出现自动注入失败等问题。例如3.5.x系列对应SpringBoot 2.7.x，这是实际开发中容易踩的版本兼容坑。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 系统核心模块设计
2.1 用户服务模块
采用Spring Security OAuth2实现多角色认证：
java复制@Configuration
@EnableWebSecurity
public class SecurityConfig extends WebSecurityConfigurerAdapter {
@Override
protected void configure(HttpSecurity http) throws Exception {
http.authorizeRequests()
.antMatchers("/api/customer/**").hasRole("CUSTOMER")
.antMatchers("/api/delivery/**").hasRole("DELIVERY")
.antMatchers("/api/admin/**").hasRole("ADMIN")
.anyRequest().authenticated()
.and()
.oauth2ResourceServer().jwt();
}
}
用户表设计特别注意了鲜奶订购特有的字段：
sql复制CREATE TABLE `user` (
`id` bigint NOT NULL AUTO_INCREMENT,
`username` varchar(50) UNIQUE,
`password` varchar(100),
`mobile` varchar(20) NOT NULL,
`delivery_address` json DEFAULT NULL,
`preferred_delivery_time` varchar(20) COMMENT '晨配/晚配',
`subscription_model` tinyint COMMENT '0-单次 1-周订 2-月订',
PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
2.2 商品与库存管理
鲜奶商品需要特殊字段设计：
java复制@Entity
@Table(name = "milk_product")
public class MilkProduct {
@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;
private String name;
private String specification; // 250ml/500ml等
@Column(name = "shelf_life")
private Integer shelfLife; // 保质期天数
@Column(name = "require_refrigeration")
private Boolean requireRefrigeration; // 是否需要冷链
@Column(name = "daily_production")
private Integer dailyProduction; // 日产量限制
@Column(name = "cut_off_time")
private LocalTime cutOffTime; // 当日订购截止时间
}
库存管理采用Redis缓存+数据库双写策略，防止超卖：
java复制public boolean reduceStock(Long productId, int quantity) {
String lockKey = "stock_lock:" + productId;
try {
// 分布式锁防止并发超卖
boolean locked = redisTemplate.opsForValue()
.setIfAbsent(lockKey, "1", 10, TimeUnit.SECONDS);
if (!locked) {
throw new BusinessException("操作太频繁");
}
// 实际扣减逻辑
int affected = productMapper.reduceStock(productId, quantity);
if (affected == 0) {
throw new BusinessException("库存不足");
}
// 更新缓存
redisTemplate.opsForValue()
.decrement("stock:" + productId, quantity);
return true;
} finally {
redisTemplate.delete(lockKey);
}
}
3. 订单系统的特殊设计
3.1 周期性订购实现
鲜奶订购最大的特点是周期性配送，我们设计了灵活的订阅模式：
java复制public class OrderScheduler {
@Scheduled(cron = "0 0 22 * * ?") // 每晚10点生成次日订单
public void generateSubscriptionOrders() {
// 1. 查询所有订阅用户
List<Subscription> subscriptions = subscriptionMapper
.findActiveSubscriptions();
// 2. 为每个订阅生成订单
subscriptions.forEach(sub -> {
Order order = new Order();
order.setUserId(sub.getUserId());
order.setDeliveryDate(LocalDate.now().plusDays(1));
order.setDeliveryTimeSlot(sub.getPreferredTime());
// 3. 扣减库存并创建订单
inventoryService.reduceStock(sub.getProductId(), sub.getQuantity());
orderMapper.insert(order);
// 4. 发送MQ通知
jmsTemplate.convertAndSend("order.queue", order);
});
}
}
3.2 冷链配送追踪
集成物联网温度传感器数据：
java复制@RestController
@RequestMapping("/api/delivery")
public class DeliveryController {
@PostMapping("/{orderId}/temperature")
public ResponseEntity<?> uploadTemperatureData(
@PathVariable Long orderId,
@RequestBody TemperatureDTO dto) {
// 记录温度轨迹
temperatureLogService.record(
orderId,
dto.getTemperature(),
dto.getTimestamp(),
dto.getLocation());
// 检查是否超温
if (dto.getTemperature() > 4) {
alertService.sendTemperatureAlert(orderId);
}
return ResponseEntity.ok().build();
}
}
4. 系统部署与监控方案
4.1 Docker化部署
采用多阶段构建优化镜像大小：
dockerfile复制# 构建阶段
FROM maven:3.8.6-jdk-11 AS build
WORKDIR /app
COPY pom.xml .
RUN mvn dependency:go-offline
COPY src /app/src
RUN mvn package -DskipTests
# 运行阶段
FROM openjdk:11-jre-slim
WORKDIR /app
COPY --from=build /app/target/milk-order-*.jar /app/app.jar
EXPOSE 8080
ENTRYPOINT ["java","-jar","/app/app.jar"]
使用docker-compose编排服务：
yaml复制version: '3'
services:
app:
build: .
ports:
- "8080:8080"
environment:
- SPRING_PROFILES_ACTIVE=prod
depends_on:
- redis
- mysql
- activemq
redis:
image: redis:6
ports:
- "6379:6379"
mysql:
image: mysql:8.0
environment:
MYSQL_ROOT_PASSWORD: milk@123
ports:
- "3306:3306"
volumes:
- mysql_data:/var/lib/mysql
activemq:
image: rmohr/activemq:5.15.9
ports:
- "61616:61616"
- "8161:8161"
volumes:
mysql_data:
4.2 SpringBoot Admin监控
配置自监控端点：
properties复制# application-prod.properties
spring.boot.admin.client.url=http://localhost:8080
management.endpoints.web.exposure.include=*
management.endpoint.health.show-details=always
自定义健康检查指标：
java复制@Component
public class DeliveryHealthIndicator
implements HealthIndicator {
@Override
public Health health() {
// 检查当日未配送订单
int pendingCount = orderMapper.countPendingDeliveries();
if (pendingCount > 100) {
return Health.down()
.withDetail("pending_orders", pendingCount)
.build();
}
return Health.up()
.withDetail("pending_orders", pendingCount)
.build();
}
}
5. 开发中的典型问题与解决方案
5.1 大文件上传优化
针对用户上传身份证等需求，采用分片上传：
java复制@PostMapping("/upload")
public ResponseEntity<?> uploadChunk(
@RequestParam("file") MultipartFile file,
@RequestParam("chunkNumber") int chunkNumber,
@RequestParam("totalChunks") int totalChunks,
@RequestParam("identifier") String identifier) {
// 临时存储分片
String tempDir = "/tmp/uploads/" + identifier;
File dir = new File(tempDir);
if (!dir.exists()) dir.mkdirs();
File chunk = new File(dir, chunkNumber + ".part");
try {
file.transferTo(chunk);
// 如果是最后一个分片则合并
if (chunkNumber == totalChunks - 1) {
mergeFiles(tempDir, identifier);
}
return ResponseEntity.ok().build();
} catch (IOException e) {
return ResponseEntity.status(500).build();
}
}
5.2 定时任务幂等性保障
为防止重复生成订单，采用数据库乐观锁：
sql复制UPDATE subscription
SET last_order_date = CURRENT_DATE
WHERE id = ? AND last_order_date < CURRENT_DATE
5.3 生产环境日志处理
使用Logstash收集日志：
groovy复制input {
file {
path => "/var/log/milk-order/*.log"
start_position => "beginning"
}
}
filter {
grok {
match => { "message" => "%{TIMESTAMP_ISO8601:timestamp} %{LOGLEVEL:level} %{NUMBER:pid} --- \[%{DATA:thread}\] %{DATA:class} : %{GREEDYDATA:message}" }
}
}
output {
elasticsearch {
hosts => ["elasticsearch:9200"]
index => "milk-order-%{+YYYY.MM.dd}"
}
}
6. 性能优化实践
6.1 数据库查询优化
针对高频查询使用MyBatis-Plus分页插件：
java复制Page<Order> page = new Page<>(1, 10);
orderMapper.selectPage(page,
Wrappers.<Order>query()
.eq("user_id", userId)
.orderByDesc("create_time"));
配置多数据源支持报表查询：
java复制@Configuration
@MapperScan(basePackages = "com.milk.report", sqlSessionFactoryRef = "reportSqlSessionFactory")
public class ReportDataSourceConfig {
@Bean
@ConfigurationProperties("spring.datasource.report")
public DataSource reportDataSource() {
return DataSourceBuilder.create().build();
}
@Bean
public SqlSessionFactory reportSqlSessionFactory(
@Qualifier("reportDataSource") DataSource dataSource) throws Exception {
SqlSessionFactoryBean bean = new SqlSessionFactoryBean();
bean.setDataSource(dataSource);
bean.setMapperLocations(
new PathMatchingResourcePatternResolver()
.getResources("classpath:mapper/report/*.xml"));
return bean.getObject();
}
}
6.2 缓存策略设计
采用多级缓存架构：
- 本地Caffeine缓存：<100ms过期，应对瞬时高峰
- Redis集群缓存：30分钟过期，共享缓存
- 数据库：最终数据源
配置示例：
java复制@Configuration
@EnableCaching
public class CacheConfig {
@Bean
public CacheManager cacheManager() {
CaffeineCacheManager manager = new CaffeineCacheManager();
manager.setCaffeine(Caffeine.newBuilder()
.expireAfterWrite(5, TimeUnit.MINUTES)
.maximumSize(1000));
return manager;
}
@Bean
public RedisCacheManager redisCacheManager(RedisConnectionFactory factory) {
RedisCacheConfiguration config = RedisCacheConfiguration.defaultCacheConfig()
.entryTtl(Duration.ofMinutes(30))
.disableCachingNullValues();
return RedisCacheManager.builder(factory)
.cacheDefaults(config)
.build();
}
}
7. 安全防护措施
7.1 接口防刷策略
采用Guava RateLimiter实现限流：
java复制@Aspect
@Component
public class RateLimitAspect {
private final Map<String, RateLimiter> limiters =
new ConcurrentHashMap<>();
@Around("@annotation(rateLimit)")
public Object around(ProceedingJoinPoint pjp, RateLimit rateLimit)
throws Throwable {
String key = rateLimit.value();
RateLimiter limiter = limiters.computeIfAbsent(key,
k -> RateLimiter.create(rateLimit.perSecond()));
if (!limiter.tryAcquire()) {
throw new BusinessException("操作太频繁，请稍后再试");
}
return pjp.proceed();
}
}
7.2 敏感数据脱敏
使用Jackson自定义序列化：
java复制public class SensitiveSerializer extends JsonSerializer<String> {
@Override
public void serialize(String value, JsonGenerator gen,
SerializerProvider provider) throws IOException {
if (value == null) {
gen.writeNull();
return;
}
// 手机号脱敏
if (value.matches("^1[3-9]\\d{9}$")) {
gen.writeString(value.replaceAll("(\\d{3})\\d{4}(\\d{4})", "$1****$2"));
}
// 地址脱敏
else {
gen.writeString(value.length() > 4 ?
value.substring(0, 2) + "****" +
value.substring(value.length() - 2) : "****");
}
}
}
7.3 定期安全扫描
集成OWASP Dependency-Check：
xml复制<plugin>
<groupId>org.owasp</groupId>
<artifactId>dependency-check-maven</artifactId>
<version>6.5.3</version>
<executions>
<execution>
<goals>
<goal>check</goal>
</goals>
</execution>
</executions>
</plugin>
8. 前后端分离实践
8.1 接口文档管理
使用Swagger3配置：
java复制@Configuration
@EnableOpenApi
public class SwaggerConfig {
@Bean
public Docket api() {
return new Docket(DocumentationType.OAS_30)
.select()
.apis(RequestHandlerSelectors.basePackage("com.milk.web"))
.paths(PathSelectors.any())
.build()
.apiInfo(apiInfo());
}
private ApiInfo apiInfo() {
return new ApiInfoBuilder()
.title("鲜奶订购系统API")
.description("包含用户端、配送端、管理端接口")
.version("1.0")
.build();
}
}
8.2 跨域解决方案
精细化CORS配置：
java复制@Configuration
public class WebConfig implements WebMvcConfigurer {
@Override
public void addCorsMappings(CorsRegistry registry) {
registry.addMapping("/api/**")
.allowedOrigins("https://milk-store.com", "https://admin.milk-store.com")
.allowedMethods("GET", "POST", "PUT", "DELETE")
.allowedHeaders("*")
.exposedHeaders("X-Auth-Token")
.allowCredentials(true)
.maxAge(3600);
}
}
8.3 前端联调技巧
使用Mock.js模拟接口：
javascript复制Mock.mock('/api/orders', 'get', {
'list|10': [{
'id|+1': 1,
'orderNo': /MNO\d{10}/,
'productName': '@ctitle(5,10)鲜牛奶',
'quantity|1-5': 1,
'status|1': ['pending', 'delivering', 'completed'],
'deliveryTime': '@time'
}]
})
9. 持续集成与交付
9.1 Jenkins流水线配置
完整的CI/CD流程：
groovy复制pipeline {
agent any
stages {
stage('Checkout') {
steps {
git branch: 'main',
url: 'git@github.com:milk-team/order-system.git'
}
}
stage('Build') {
steps {
sh 'mvn clean package -DskipTests'
}
}
stage('Test') {
steps {
sh 'mvn test'
}
post {
always {
junit 'target/surefire-reports/*.xml'
}
}
}
stage('Docker Build') {
steps {
script {
docker.build("milk-order:${env.BUILD_ID}")
}
}
}
stage('Deploy to Test') {
steps {
sshPublisher(
publishers: [
sshPublisherDesc(
configName: 'test-server',
transfers: [
sshTransfer(
sourceFiles: 'target/milk-order-*.jar',
removePrefix: 'target',
remoteDirectory: '/app',
execCommand: 'sudo systemctl restart milk-order'
)
]
)
]
)
}
}
}
}
9.2 自动化测试策略
集成测试示例：
java复制@SpringBootTest
@AutoConfigureMockMvc
class OrderControllerTest {
@Autowired
private MockMvc mockMvc;
@Test
@WithMockUser(roles = "CUSTOMER")
void createOrder() throws Exception {
String requestJson = """
{
"productId": 1,
"quantity": 2,
"deliveryDate": "2023-08-15",
"deliveryTime": "MORNING"
}
""";
mockMvc.perform(post("/api/orders")
.contentType(MediaType.APPLICATION_JSON)
.content(requestJson))
.andExpect(status().isOk())
.andExpect(jsonPath("$.orderNo").exists());
}
}
10. 实际运营中的经验总结
在系统上线后，我们收获了以下几个关键经验：
-
冷链配送的实时监控必不可少，初期因温度传感器数据传输延迟导致过几起投诉，后来通过优化MQTT协议传输频率和增加边缘计算预处理解决了这个问题。
-
订阅模式的灵活性需要特别设计，很多用户希望可以临时暂停某次配送而不是取消整个订阅，我们在第二版增加了"跳过本次配送"功能，用户留存率提升了27%。
-
库存预测算法需要持续优化，最初基于简单线性回归的预测模型在节假日经常失准，后来引入LSTM神经网络后，预测准确率提升到92%以上。
-
支付超时处理要更人性化，鲜奶产品有很强的时效性，最初30分钟未支付自动取消订单的策略导致很多用户不满，调整为2小时并增加支付提醒短信后，订单转化率提高了15%。
-
异常天气应对机制需要提前准备，遇到暴雨等极端天气时，我们开发了紧急调整配送路线和时间的运营后台功能，大大降低了配送员的工单投诉率。
这个项目让我深刻体会到，生鲜类电商系统与传统电商在技术架构上看似相似，但在细节处理上却有诸多特殊考量。每个决策都必须围绕"保鲜"和"时效"这两个核心需求展开，这既是挑战也是技术创新的机会。