agilelabs-fx-docs main tutorials/backend-init/run-and-verify.md

运行与验证后端骨架

本页把前面几步串成一个完整闭环,确认解决方案、宿主、最小 WebAPI、数据访问骨架和认证链路已经一起工作。做完这一页后,就可以进入前端初始化主线。

这篇教程解决什么

  • 后端骨架完成后要检查哪些点。
  • 怎样确认宿主、公开接口和受保护接口都已经可用。
  • 什么时候可以认为“后端初始化”已经达标。

前置条件

配套代码

我们要做的事

  • 统一跑一遍最小自检。
  • 验证公开接口、受保护接口和健康检查都已经打通。
  • 给进入前端初始化主线准备稳定基线。

操作步骤

  1. 启动后端样例:
dotnet run --project samples/tutorials/backend-starter/src/BackendStarter.Api/BackendStarter.Api.csproj
  1. 验证健康检查接口:
curl http://localhost:5000/healthz
  1. 验证公开接口:
curl http://localhost:5000/api/demo/hello
  1. 验证受保护接口未授权时会失败:
curl -i http://localhost:5000/api/demo/secure
  1. 验证带上演示 token 后可以访问:
curl -i \
  -H "X-Demo-Token: tutorial-token" \
  http://localhost:5000/api/demo/secure
  1. 如果你习惯从浏览器检查,可以同时打开 Swagger UI,看三个入口是否都已经暴露出来。

验证结果

  • /healthz 返回服务存活结果。
  • /api/demo/hello 返回标准前端契约结构。
  • /api/demo/secure 在带 token 和不带 token 两种情况下表现正确。
  • 后端样例已经达到可以进入前端初始化和接口联调的状态。

完成后检查

下一篇读什么