Workbuddy部署测试全攻略

本文详细拆解了Workbuddy服务从环境准备到功能验证的全流程部署测试指南，涵盖JDK/Maven/PostgreSQL/Redis四大依赖精准校验、Maven跳过测试的安全打包、application.yml配置动态覆盖、Java命令极简启动与健康接口实时验证，以及围绕认证、用户、任务三大核心模块的轻量级冒烟测试——手把手带你用五步标准化操作，在本地或测试环境快速拉起一个可访问、可交互、业务链路通畅的Workbuddy实例，让部署不再踩坑，测试真正落地。

如果您需要在本地或测试环境中完成 Workbuddy 的部署与功能验证，则需通过标准化流程确保服务组件可启动、接口可调用、基础业务逻辑可执行。以下是开展 Workbuddy 部署测试的具体方法：

一、环境依赖校验

在执行部署前，必须确认目标系统已安装并配置好所有必需的运行时依赖，缺失任一组件将导致服务无法初始化。该步骤旨在提前暴露底层环境不兼容问题，避免后续构建或启动失败。

1、执行 java -version 命令，确认 JDK 版本为 11 或 17（LTS 版本）。

2、运行 mvn -v，验证 Maven 3.6.3 及以上版本已正确配置 PATH。

3、检查 PostgreSQL 12+ 实例是否运行，使用 psql --version 和 pg_isready -h localhost -p 5432 进行双重确认。

4、确认 Redis 6.0+ 服务处于活动状态，执行 redis-cli ping 并接收返回值 PONG。

二、源码编译与打包

Workbuddy 采用 Maven 多模块结构，需按顺序完成编译、测试跳过、打包三阶段，生成可部署的 JAR 文件。此过程排除单元测试干扰，聚焦于构建产物可用性验证。

1、进入项目根目录，执行 mvn clean compile 完成源码编译。

2、运行 mvn test -Dmaven.test.skip=true 跳过测试阶段，防止因测试数据缺失中断流程。

3、执行 mvn package -DskipTests 生成 workbuddy-server/target/workbuddy-server-*.jar。

4、校验 JAR 文件完整性：使用 jar -tf workbuddy-server-*.jar | head -20 查看 MANIFEST.MF 与 BOOT-INF 是否存在。

三、配置文件注入与覆盖

Workbuddy 启动依赖 application.yml 及 profile-specific 配置，必须将数据库连接、Redis 地址、端口等参数显式注入，否则服务将使用默认占位值并启动失败。

1、复制 workbuddy-server/src/main/resources/application.yml 到独立目录如 /opt/workbuddy/config/。

2、编辑该文件，将 spring.datasource.url 改为实际 PostgreSQL 地址，例如 jdbc:postgresql://127.0.0.1:5432/workbuddy_test。

3、修改 spring.redis.host 为 127.0.0.1，spring.redis.port 为 6379。

4、设置 server.port 为未被占用端口，如 8081，避免与开发环境冲突。

四、JAR 包启动与进程验证

使用 Java 命令直接启动打包后的 JAR，并通过日志输出与系统进程双重手段确认服务已进入运行态。该步骤不依赖外部调度器，聚焦最简启动路径有效性。

1、执行启动命令：java -Dspring.config.location=file:/opt/workbuddy/config/application.yml -jar /path/to/workbuddy-server-*.jar。

2、观察控制台输出，等待出现包含 Started WorkbuddyServerApplication in 的日志行。

3、另开终端，运行 curl -I http://localhost:8081/actuator/health，确认返回 HTTP 状态码 200。

4、执行 ps aux | grep workbuddy，验证 Java 进程中存在对应 JAR 路径且状态为 S（休眠）或 R（运行）。

五、核心接口冒烟测试

在服务成功启动后，需对认证、用户、任务三大主域接口发起最小集请求，验证控制器层路由、服务层逻辑、数据源连通性三者协同正常。此阶段不覆盖全量用例，仅确认关键链路可达。

1、调用登录接口：curl -X POST http://localhost:8081/api/auth/login -H "Content-Type: application/json" -d '{"username":"testuser","password":"testpass"}'。

2、使用上一步返回的 JWT token，请求用户信息：curl -H "Authorization: Bearer " http://localhost:8081/api/users/me。

3、创建测试任务：curl -X POST http://localhost:8081/api/tasks -H "Authorization: Bearer " -H "Content-Type: application/json" -d '{"title":"Smoke Test Task","status":"TODO"}'。

4、查询任务列表并检查响应体中是否包含刚创建的任务 ID：curl -H "Authorization: Bearer " http://localhost:8081/api/tasks?size=1。

今天关于《Workbuddy部署测试全攻略》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！