VS2022中Unchase OpenApi扩展日期类型映射异常求助

DevOps 小满

2026-8-3

解决Unchase OpenApi在VS2022中同时支持DateTime和DateTimeOffset的方法

方法1：通过OpenAPI规范明确指定类型

在你的OpenAPI YAML/JSON文件中，针对不同日期字段添加自定义扩展标记，让Unchase OpenApi扩展精准识别对应类型：

需映射为DateTime的字段，在date-time格式基础上添加x-type: System.DateTime
需映射为DateTimeOffset的字段，添加x-type: System.DateTimeOffset

示例（YAML格式）：

components:
  schemas:
    BusinessModel:
      type: object
      properties:
        localCreateTime:
          type: string
          format: date-time
          x-type: System.DateTime
        utcExpireTime:
          type: string
          format: date-time
          x-type: System.DateTimeOffset

方法2：自定义Unchase OpenApi的T4模板

Unchase OpenApi支持自定义生成模板，你可以修改类型映射逻辑来适配双日期类型需求：

在VS2022的Unchase OpenApi设置中，找到「Template Files」选项，复制默认的C#客户端模板到本地项目
打开复制的模板文件（如CSharpClientGenerator.tt），找到处理date-time类型的代码块，替换为以下逻辑：

// 优先读取自定义扩展指定的类型
var customDateTimeType = schema.Extensions.TryGetValue("x-type", out var typeValue) ? typeValue.ToString() : null;
if (!string.IsNullOrEmpty(customDateTimeType))
{
    return customDateTimeType;
}
// 保留原有默认类型逻辑作为 fallback
return Settings.DateTimeType;