一、 Nginx: 项目网关与流量调度
核心原理
反向代理 (Reverse Proxy):
在Web架构中，Nginx作为系统的统一入口（API网关），接收所有外部客户端请求。它通过解析请求的URL路径（location指令），判断请求的意图，然后将请求路由到正确的内部后端微服务。这些后端服务运行在各自的端口上，不直接对公网暴露。此模式增强了系统的安全性，并为日志、监控、权限等提供了统一的管理层面。
负载均衡 (Load Balancing):
对于高流量服务，单实例存在性能瓶颈和单点故障风险。负载均衡机制通过upstream指令定义一个由多个相同服务实例组成的服务器集群。当请求被路由到此集群时，Nginx会根据预设策略（如加权轮询）选择一个实例处理请求。这实现了请求压力的分摊，保证了服务的高可用性和水平扩展能力。
Nginx
upstream webservers {server 127.0.0.1:8080 weight=90;#server 127.0.0.1:8088 weight=10;
}server {listen 80;server_name localhost;location /api/ {proxy_pass http://localhost:8080/admin/;}location /user/ {proxy_pass http://webservers/user/;}
}
upstream webservers { ... }
此代码块定义了一个名为 webservers 的后端服务器集群，用于实现负载均衡。其中server指令定义了集群内的成员。当前配置中，127.0.0.1:8080服务器是主要的工作节点，权重为90，而127.0.0.1:8088服务器则被注释，处于非活动状态。
location /api/ { ... }
此代码块定义了针对后台管理端请求的路由规则。它匹配所有以/api/开头的URL，并通过proxy_pass指令，将这些请求以反向代理的方式转发给运行在localhost:8080端口的后端管理服务。
location /user/ { ... }
此代码块定义了针对小程序用户端请求的路由规则。它匹配所有以/user/开头的URL，并通过proxy_pass指令，将请求转发给上面定义的webservers服务器集群。Nginx会自动根据集群内服务器的权重等策略进行负载均衡。
二、 MD5: 密码的安全存储与验证
核心原理
MD5是一种单向哈希函数，能将任意数据转换为一个固定长度且不可逆的“数字指纹”。在用户认证中，其核心价值在于避免在数据库中存储用户的明文密码，以此提升账户安全性。验证过程不比较密码原文，而是比较密码原文经过哈希计算后的“指纹”是否与数据库中预存的“指纹”一致。这依赖于哈希函数的确定性：相同的输入永远产生相同的输出。
代码示例 (EmployeeServiceImpl.java中的login方法)
Java
public Employee login(EmployeeLoginDTO employeeLoginDTO) {String username = employeeLoginDTO.getUsername();String password = employeeLoginDTO.getPassword();Employee employee = employeeMapper.getByUsername(username);if (employee == null) {throw new AccountNotFoundException(MessageConstant.ACCOUNT_NOT_FOUND);}password = DigestUtils.md5DigestAsHex(password.getBytes());if (!password.equals(employee.getPassword())) {throw new PasswordErrorException(MessageConstant.PASSWORD_ERROR);}if (employee.getStatus() == StatusConstant.DISABLE) {throw new AccountLockedException(MessageConstant.ACCOUNT_LOCKED);}return employee;
}
代码解读
首先，方法从
employeeLoginDTO对象中获取用户在登录时提交的明文username和password。使用
employeeMapper.getByUsername(username)从数据库查询用户信息。此时，返回的employee对象中所包含的密码employee.getPassword()是先前在注册时就已经过MD5加密处理的哈希字符串。password = DigestUtils.md5DigestAsHex(password.getBytes());这一行是核心步骤。它调用Spring框架的工具类，将用户本次输入的明文密码也进行相同的MD5哈希计算。if (!password.equals(employee.getPassword()))这一行进行最终的验证。它比较的是两个MD5哈希值：一个是刚由用户输入计算得出的，另一个是从数据库中读取的。如果两者不一致，则证明密码错误。
安全提醒: 尽管此方法诠释了哈希验证原理，但因MD5算法本身存在安全弱点，现代项目中更推荐使用BCrypt等加盐慢哈希算法。
三、 Knife4j: API文档的自动化生成与增强UI
核心原理
Knife4j是基于Swagger/OpenAPI规范的API文档UI增强工具。其工作模式为**“后端代码驱动，前端界面渲染”**：
后端生成数据: 项目中引入的
Springfox或Springdoc库，会扫描Java Controller代码中的特定注解（如@ApiOperation），并在项目运行时，自动生成一份遵循OpenAPI规范的JSON格式的API结构描述文件。这实现了“代码即文档”，保证了文档与实现的高度一致。前端渲染界面: Knife4j本身提供了一套美观且功能强大的前端UI资源。这个UI界面会请求并解析上一步生成的JSON数据，最终将其渲染成一个可交互、带在线调试功能的Web文档页面，极大地提升了API文档的可读性和易用性。
1. 配置API扫描规则 (位于WebMvcConfiguration.java)
代码示例
Java
@Bean
public Docket docket() {ApiInfo apiInfo = new ApiInfoBuilder().title("苍穹外卖项目接口文档").version("2.0").description("苍穹外卖项目接口文档").build();Docket docket = new Docket(DocumentationType.SWAGGER_2).apiInfo(apiInfo).select().apis(RequestHandlerSelectors.basePackage("com.sky.controller")).paths(PathSelectors.any()).build();return docket;
}
代码解读
此
@Bean方法创建并配置了一个Docket实例，它是Swagger/Springfox的核心配置对象。.apiInfo()用于设置文档首页的标题、版本等元数据。.select()开始进行扫描配置。.apis(RequestHandlerSelectors.basePackage("com.sky.controller"))是关键配置，它指示框架只扫描com.sky.controller这个包下的所有Controller类来生成文档。.paths(PathSelectors.any())表示对扫描到的Controller中的所有接口路径都生成文档。
2. 配置UI界面的访问路径 (位于WebMvcConfiguration.java)
代码示例
Java
@Override
protected void addResourceHandlers(ResourceHandlerRegistry registry) {registry.addResourceHandler("/doc.html").addResourceLocations("classpath:/META-INF/resources/");registry.addResourceHandler("/webjars/**").addResourceLocations("classpath:/META-INF/resources/webjars/");
}
代码解读
此方法用于设置静态资源映射。
它告诉Spring MVC框架，当浏览器访问
/doc.html或/webjars/**这些URL时，不要去Controller里寻找处理器，而是应该去Java的classpath下的特定位置（META-INF/resources/）去寻找对应的静态文件（HTML, CSS, JS）。Knife4j的UI界面文件就打包存放在这些路径下。完成这两步配置后，启动项目并访问
http://localhost:8080/doc.html即可看到API文档。
