运行与验证后端骨架
本页把前面几步串成一个完整闭环,确认解决方案、宿主、最小 WebAPI、数据访问骨架和认证链路已经一起工作。做完这一页后,就可以进入前端初始化主线。
这篇教程解决什么
- 后端骨架完成后要检查哪些点。
- 怎样确认宿主、公开接口和受保护接口都已经可用。
- 什么时候可以认为“后端初始化”已经达标。
前置条件
- 已完成 接入认证骨架。
- 本地已经具备
.NET 10 SDK。
配套代码
- 当前样例:backend-starter
- 当前关注文件:Program.cs
- 当前关注文件:DemoController.cs
我们要做的事
- 统一跑一遍最小自检。
- 验证公开接口、受保护接口和健康检查都已经打通。
- 给进入前端初始化主线准备稳定基线。
操作步骤
- 启动后端样例:
dotnet run --project samples/tutorials/backend-starter/src/BackendStarter.Api/BackendStarter.Api.csproj
- 验证健康检查接口:
curl http://localhost:5000/healthz
- 验证公开接口:
curl http://localhost:5000/api/demo/hello
- 验证受保护接口未授权时会失败:
curl -i http://localhost:5000/api/demo/secure
- 验证带上演示 token 后可以访问:
curl -i \
-H "X-Demo-Token: tutorial-token" \
http://localhost:5000/api/demo/secure
- 如果你习惯从浏览器检查,可以同时打开 Swagger UI,看三个入口是否都已经暴露出来。
验证结果
/healthz返回服务存活结果。/api/demo/hello返回标准前端契约结构。/api/demo/secure在带 token 和不带 token 两种情况下表现正确。- 后端样例已经达到可以进入前端初始化和接口联调的状态。