NSwag生成RestApi客户端时4XX状态码代码编译失败求解决方案

问题场景 #

我的OpenAPI定义包含如下状态码声明：

'200':
     [...]
'4XX':
     $ref: '#/components/responses/error'

在Visual Studio 2022中使用NSwag生成C#代码时，得到了无法编译的代码片段：

if (status_ == 4XX)
{

期望生成的代码是类似Swagger Editor产出的范围判断逻辑：

if (((int)status_ ) >= 400)
{

已经尝试过更新NSwag版本、使用NSwagStudio，但问题仍未解决。

可行解决方案 #

• 替换通配符状态码为具体值
  NSwag对4XX这类通配符状态码的处理存在兼容问题，直接把通配符替换为需要的具体4开头状态码列表，比如：

  '400':
    $ref: '#/components/responses/error'
  '401':
    $ref: '#/components/responses/error'
  '403':
    $ref: '#/components/responses/error'
  # 按需添加其他4XX状态码
  

  这种方式虽然需要逐个声明状态码，但能直接保证生成的代码可编译。

• 自定义NSwag代码生成模板
  NSwag支持通过Handlebars模板自定义代码生成逻辑：

  1. 找到NSwag的C#客户端模板文件（默认名为CSharpClientTemplate.hbs）
  2. 定位到处理状态码判断的代码块，修改通配符状态码的处理逻辑：
     将原本直接输出状态码标识符的逻辑，替换为范围判断代码，示例如下：

     {{#if isRangeStatusCode}}
     if (((int)status_) >= {{rangeStart}} && ((int)status_) < {{rangeEnd}})
     {{else}}
     if (status_ == {{statusCode}})
     {{/if}}
     

  3. 在NSwag的配置中指定使用该自定义模板生成代码。

• 使用NSwag命令行工具并启用范围状态码参数
  如果你的NSwag版本支持，在生成代码的命令中添加--use-range-status-codes参数，该参数会让NSwag自动将4XX这类通配符解析为对应的状态码范围判断，而非直接输出无效的标识符。

内容的提问来源于stack exchange，提问作者Nono