SYSTEM
工程化工具与文档
src/content/notes/growth/工程化工具与文档.md 九、工程化工具与文档
问题 16:Maven 的 spring-boot-maven-plugin 有什么作用?
问题本身:
问:你项目是怎么打包的? 追问:spring-boot-maven-plugin 有什么作用?
为什么要这么做:
- 这个插件把普通 jar 包打成可执行 jar 包(内嵌 Tomcat + 依赖库)
- 没有它,打出来的 jar 包不能直接运行
具体怎么做:
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
打包流程:
mvn package先编译项目- spring-boot-maven-plugin 执行 repackage 目标
- 将项目及其依赖打包成一个可执行 jar 包
项目实战:
- 项目用
spring-boot-maven-plugin打包 - 打包后直接
java -jar express-manage.jar运行
如何验证:
- 运行
mvn package,确认生成可执行 jar 包 - 运行
java -jar,确认项目正常启动 - 查看 jar 包内容,确认包含依赖库
问题 17:你是怎么和前端协作的?
问题本身:
问:你项目里是怎么和前端协作的? 追问:有没有遇到过前后端联调问题?怎么解决的?
为什么要这么做:
- 前后端协作需要明确接口文档,避免字段名、类型不一致
- 先写文档再开发,能减少联调问题
具体怎么做:
- 开发前:一起评审接口文档,对齐字段名、类型、请求方式
- 开发中:后端先写好接口,用 Postman 自测通过,把接口文档给前端
- 联调时:前端联调发现问题,配合排查
- 上线前:全链路测试,确保核心流程跑通
项目实战:
- 注册登录 Bug:前端未传 username 字段,后端自动生成 username,导致登录失败
- 解决:注册接口加 username 字段,登录接口用 username 登录
- 教训:先写接口文档再开发,前后端联调前先对齐字段
如何验证:
- 查看接口文档,确认字段名、类型、请求方式齐全
- 用 Postman 测试接口,确认正常返回
- 前后端联调,确认数据传递正确