netcorepal-cloud-framework v3.3.0 发布：增强可观测性，补强时间处理与代码分析可视化能力

netcorepal-cloud-framework v3.3.0 已正式发布。

作为一个基于 ASP.NET Core 的 DDD 落地战术框架，本次版本继续围绕工程实践中的关键问题进行完善，重点在可观测性、时间字段处理、代码分析可视化体验以及底层稳定性等方面带来增强与修复。

版本亮点

本次 v3.3.0 的主要更新包括：

• 新增 NetCorePal.OpenTelemetry.Diagnostics 中英文文档
• 为 EF Core + Npgsql 增加 DateTimeOffset 写入前转 UTC 的可选补丁
• 修复代码流分析可视化中的两个实际问题
• 更新部分底层依赖

OpenTelemetry 文档补齐

新版本补充了 NetCorePal.OpenTelemetry.Diagnostics 的中英文文档，并已加入文档导航。

文档覆盖了以下内容：

• 安装与基础配置
• 自动追踪的活动类型
• 与 Jaeger、Zipkin、Azure Application Insights 的集成方式
• 采样与导出建议

框架支持对命令、领域事件、集成事件以及事务处理过程进行自动追踪，可为 DDD 与事件驱动架构下的链路观测和问题排查提供支持。

Npgsql 下 DateTimeOffset 可选转 UTC

针对 PostgreSQL 场景，新版本增加了一个可选补丁，用于在写入前将 DateTimeOffset 统一转换为 UTC。

示例：

builder.Services.AddDbContext<ApplicationDbContext>(options =>
{
    options.UseNpgsql(connectionString);
    options.UseDateTimeOffsetUtcConversionForNpgsql();
});

该能力适用于存在跨时区、国际化、多租户等需求的系统，有助于降低时间字段在数据库读写过程中的潜在一致性问题。

代码分析可视化修复

本次版本修复了两个与代码分析可视化相关的问题。

一是修复聚合关系图中多个 Endpoint 被错误合并为同一节点的问题，避免图表结果失真。

二是修复 GenerateVisualizationHtml 在未传入 snapshots 时页面脚本报错的问题，当前即使直接使用分析结果，也可以正常生成可视化页面。

上述修复进一步提升了代码分析工具在实际使用场景中的可用性与稳定性。

依赖更新

本次还升级了以下依赖：

• AsyncKeyedLock
• Backport.System.Threading.Lock

相关更新有助于进一步提升框架底层依赖的稳定性与兼容性。

升级建议

建议以下场景优先关注并评估升级：

• 已接入或计划接入 OpenTelemetry 的项目
• 使用 PostgreSQL / Npgsql 且包含 DateTimeOffset 字段的项目
• 正在使用代码分析与可视化能力的项目
• 对运行稳定性和依赖更新较敏感的生产项目

整体来看，v3.3.0 是一次以增强与修复为主的版本更新，适合持续跟进。

致谢

感谢所有为 v3.3.0 提交代码、文档与改进建议的贡献者。

本次版本的相关工作得到了 @witskeeper、@zhouda1fu、@MarkCiliaVincenti 等贡献者的支持。正是社区持续、稳定的共建投入，推动了 netcorepal-cloud-framework 在工程实践中的不断完善。

相关链接

• Release 页面：https://github.com/netcorepal/netcorepal-cloud-framework/releases/tag/v3.3.0
• Full Changelog：https://github.com/netcorepal/netcorepal-cloud-framework/compare/v3.2.1...v3.3.0
• 项目地址：https://github.com/netcorepal/netcorepal-cloud-framework
• 官方文档：https://netcorepal.github.io/netcorepal-cloud-framework

更多内容，欢迎关注同名公众号： 老肖想当外语大佬

原文链接： https://mp.weixin.qq.com/s/qc0qQ872wZ6-03x2WSeOLQ