在 Kubernetes 中如何调试 .NET 微服务？

来源：这里教程网时间：2026-02-21 17:28:09 作者：

调试 Kubernetes 中的 .NET 微服务需要结合日志、监控、网络和运行时诊断工具。直接在 Pod 中排查问题是最常见的方式，下面介绍几种实用方法。

查看容器日志

每个 .NET 微服务运行在独立的 Pod 容器中，最直接的调试方式是查看其输出日志。

使用 kubectl logs 查看标准输出和错误信息 如果 Pod 有多个容器，用 -c ainer-name> 指定目标容器 添加 --follow 实时跟踪日志，类似 tail -f 启用结构化日志（如 Serilog 或 Microsoft.Extensions.Logging.JsonConsole）能更方便地排查异常堆栈和请求上下文

进入容器执行诊断命令

当日志不足以定位问题时，可以进入正在运行的容器内部检查环境。

使用 kubectl exec -it -- /bin/sh 进入容器 shell 检查配置文件路径、环境变量（printenv）是否正确加载 验证网络连通性，比如用 curl 调用依赖服务或健康检查接口 确认 .NET 运行时版本（dotnet --info）与预期一致

启用远程调试（开发环境）

在开发或测试环境中，可通过端口转发实现远程调试。

确保镜像包含调试工具（如 vsdbg），基础镜像推荐使用 mcr.microsoft.com/dotnet/sdk 部署时开放调试端口（通常是 5899 或 4024） 使用 kubectl port-forward 5899:5899 将调试端口映射到本地 在 Visual Studio 或 VS Code 中连接到 localhost:5899 进行断点调试

使用分布式追踪和指标监控

生产环境应避免手动介入，建议集成可观测性体系。

通过 OpenTelemetry 收集请求链路，分析性能瓶颈或失败调用 暴露 Prometheus 格式的指标（如 HTTP 请求延迟、GC 暂停时间） 配合 Grafana 展示 .NET 运行时指标（可使用 dotnet-monitor 工具） 设置告警规则，及时发现内存泄漏或高 CPU 使用情况

基本上就这些。关键是建立从日志到指标再到调用链的完整观测能力，再结合临时调试手段快速响应问题。