同站点Angular调用ASP.NET Web API字段首字母小写，跨域保留原格式如何控制？

这种差异确实挺闹心的，跨站点迁移时很容易搞乱前端的模型映射逻辑。核心原因其实和ASP.NET Web API的JSON序列化配置、Angular端的响应解析行为脱不了干系，下面给你具体的解决思路和方案：

1. 统一ASP.NET Web API的序列化格式（推荐首选） #

不管请求是同域还是跨域，让API返回的JSON字段格式保持一致才是最根本的解决办法，这样前端完全不用做额外适配。

针对ASP.NET Core（.NET Core/.NET 5+） #

在Program.cs（旧版本是Startup.cs）里配置JSON序列化规则，强制统一字段命名风格：

// Program.cs
var builder = WebApplication.CreateBuilder(args);

// 配置System.Text.Json序列化规则
builder.Services.AddControllers()
    .AddJsonOptions(options =>
    {
        // 如果要保留服务器端的PascalCase（首字母大写），禁用默认的camelCase
        options.JsonSerializerOptions.PropertyNamingPolicy = null;
        
        // 如果想统一用camelCase（首字母小写），就启用下面的配置
        // options.JsonSerializerOptions.PropertyNamingPolicy = JsonNamingPolicy.CamelCase;
    });

var app = builder.Build();
// ...其他中间件配置
app.Run();

针对旧版ASP.NET Web API（.NET Framework） #

在WebApiConfig.cs里配置Json.NET（Newtonsoft.Json）的序列化规则：

using Newtonsoft.Json.Serialization;

public static class WebApiConfig
{
    public static void Register(HttpConfiguration config)
    {
        // 配置JSON序列化规则
        var jsonFormatter = config.Formatters.JsonFormatter;
        // 保留服务器端的PascalCase格式
        jsonFormatter.SerializerSettings.ContractResolver = new DefaultContractResolver(); 
        // 如果要统一用camelCase，替换成下面的代码
        // jsonFormatter.SerializerSettings.ContractResolver = new CamelCasePropertyNamesContractResolver();
        
        // ...其他路由配置
    }
}

这样配置后，不管是同域还是跨域请求，API返回的JSON字段格式都会完全一致，从根源上消除差异。

2. Angular端统一解析规则（备选方案） #

如果暂时没法修改API配置，也可以在Angular端统一处理响应的JSON键名，确保不管API返回什么格式，前端都能正确映射到模型。

方法1：用拦截器统一转换键名 #

创建一个HTTP拦截器，自动把响应的JSON键在camelCase和PascalCase之间转换：

import { Injectable } from '@angular/core';
import { HttpInterceptor, HttpRequest, HttpHandler, HttpEvent, HttpResponse } from '@angular/common/http';
import { Observable } from 'rxjs';
import { map } from 'rxjs/operators';

@Injectable()
export class JsonCaseInterceptor implements HttpInterceptor {
  intercept(request: HttpRequest<any>, next: HttpHandler): Observable<HttpEvent<any>> {
    return next.handle(request).pipe(
      map(event => {
        if (event instanceof HttpResponse) {
          const body = event.body;
          if (body) {
            // 把camelCase转换为PascalCase，适配服务器端格式
            event = event.clone({ body: this.convertToPascalCase(body) });
          }
        }
        return event;
      })
    );
  }

  private convertToPascalCase(obj: any): any {
    if (typeof obj !== 'object' || obj === null) return obj;
    if (Array.isArray(obj)) return obj.map(item => this.convertToPascalCase(item));
    
    return Object.keys(obj).reduce((acc, key) => {
      const pascalKey = key.charAt(0).toUpperCase() + key.slice(1);
      acc[pascalKey] = this.convertToPascalCase(obj[key]);
      return acc;
    }, {} as any);
  }
}

然后在app.module.ts里注册这个拦截器：

import { HTTP_INTERCEPTORS } from '@angular/common/http';
import { JsonCaseInterceptor } from './json-case.interceptor';

@NgModule({
  providers: [
    { provide: HTTP_INTERCEPTORS, useClass: JsonCaseInterceptor, multi: true }
  ]
})
export class AppModule { }

方法2：在模型类手动指定映射键名 #

如果只有少数模型有问题，可以用class-transformer库在模型类里指定和服务器字段的映射关系：

import { JsonProperty } from 'class-transformer';

export class User {
  @JsonProperty('UserId')
  userId: number;
  
  @JsonProperty('UserName')
  userName: string;
}

然后在请求时用plainToClass转换响应：

import { plainToClass } from 'class-transformer';

this.http.get<User>('/api/users/1').pipe(
  map(response => plainToClass(User, response))
).subscribe(user => {
  console.log(user.userId); // 正确映射服务器端的UserId字段
});

总结 #

优先推荐统一ASP.NET Web API的序列化配置，这是最稳定、最省心的方案，能避免前端做一堆额外适配工作。如果API配置暂时没法改，再考虑Angular端的拦截器或模型映射方案。

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