PAYATHON 2026

Angular 19 向 .NET Core 9 后端重复发送 POST 请求

排障赵师傅

结论

OPTIONS 预检请求不会触发第二次 POST,ASP.NET Core 的 CORS middleware 也不会把 OPTIONS 转成 POST。

从日志看,这两次 POST 很可能来自不同的执行环境:

  1. 第一个 POST 没有 Origin 请求头,也没有对应的预检请求。
  2. 第二个 POST 带有 Origin: http://localhost:4200,发送前还出现了 OPTIONS。

如果项目启用了 Angular SSR 或 hydration,组件可能先在服务端渲染时执行一次 ngOnInit(),浏览器接管页面后再执行一次,导致 getAuth() 被调用两次。其他非浏览器调用方也有可能发出第一个请求,但根据现有代码,应该先排查 SSR。

Angular HttpClient 不会因为 CORS 自动重发业务请求。一次预检和一次实际请求在日志中应该是:

OPTIONS /api/accountconnect
POST    /api/accountconnect

当前日志却是:

POST                         // 没有 Origin
OPTIONS                      // 浏览器预检
POST                         // 带有 Origin

因此,预检请求本身没有造成重复 POST。

先确认第一个 POST 来自哪里

打开浏览器开发者工具的 Network 面板,清空记录并刷新页面:

  • 如果 Network 面板中只有一个 POST,而后端记录了两个,另一个请求通常来自 Angular SSR、开发代理、测试程序或其他服务端代码。
  • 如果 Network 面板中也有两个 POST,检查两条请求的 Initiator 和调用栈,找出发起请求的组件、订阅或拦截器。
  • 查看项目是否使用了 @angular/ssr、provideClientHydration()、服务端入口文件或 SSR 启动命令。
  • 在组件的构造函数和 ngOnInit() 中记录运行平台及实例编号,检查组件是否创建了两次。

例如:

import { Component, inject, PLATFORM_ID } from '@angular/core';
import { isPlatformBrowser } from '@angular/common';

export class AuthNylasComponent {
  private readonly platformId = inject(PLATFORM_ID);

  ngOnInit(): void {
    console.log(
      'AuthNylasComponent.ngOnInit',
      isPlatformBrowser(this.platformId) ? 'browser' : 'server'
    );
  }
}

后端也可以记录 Origin、User-Agent 和请求 ID:

Console.WriteLine(
    "RequestId={RequestId}, Origin={Origin}, UserAgent={UserAgent}",
    HttpContext.TraceIdentifier,
    Request.Headers.Origin.ToString(),
    Request.Headers.UserAgent.ToString()
);

不要记录完整的授权码、access token 或 refresh token。

只在浏览器中执行 token 交换

如果 token 交换应由浏览器发起,可以用 isPlatformBrowser() 阻止 SSR 阶段调用接口。这个回调页面只需读取一次查询参数,直接使用路由快照即可,无需在构造函数中长期订阅 queryParamMap。

import {
  Component,
  OnInit,
  PLATFORM_ID,
  inject
} from '@angular/core';
import { isPlatformBrowser } from '@angular/common';
import { ActivatedRoute, Router } from '@angular/router';
import { DataService } from '../../services/local';

@Component({
  selector: 'app-auth-nylas',
  imports: [],
  templateUrl: './auth-nylas.component.html',
  styleUrl: './auth-nylas.component.scss'
})
export class AuthNylasComponent implements OnInit {
  private readonly platformId = inject(PLATFORM_ID);
  private exchangeStarted = false;

  data: unknown;

  constructor(
    private readonly route: ActivatedRoute,
    private readonly router: Router,
    private readonly dataService: DataService
  ) {}

  ngOnInit(): void {
    if (!isPlatformBrowser(this.platformId) || this.exchangeStarted) {
      return;
    }

    const code = this.route.snapshot.queryParamMap.get('code');

    if (!code) {
      return;
    }

    this.exchangeStarted = true;

    this.dataService.getAuth(code).subscribe({
      next: data => {
        this.data = data;

        // 成功后从地址栏删除一次性授权码,避免刷新时再次提交。
        void this.router.navigate([], {
          relativeTo: this.route,
          queryParams: { code: null },
          queryParamsHandling: 'merge',
          replaceUrl: true
        });
      },
      error: error => {
        this.exchangeStarted = false;
        console.error('Token exchange failed', error);
      }
    });
  }
}

exchangeStarted 能防止同一个组件实例重复调用,却无法在 SSR 进程和浏览器之间共享状态。要避免 SSR 引起的重复调用,仍需使用 isPlatformBrowser(),或者把整个 token 交换流程放到后端。

如果授权流程还包含 state 参数,应先由后端验证 state,再执行 code exchange。删除 URL 中的 code 不能替代这项校验。

更稳妥的 OAuth 回调设计

一次性授权码更适合交给后端处理。常见流程如下:

  1. OAuth 提供方将用户重定向到后端 callback。
  2. 后端验证 state。
  3. 后端使用授权码交换 token。
  4. token 保存在服务端,或通过安全的 HttpOnly cookie 建立会话。
  5. 后端将用户重定向到不含授权码的 Angular 页面。

这种设计可以避免 Angular SSR、hydration、组件重建或页面刷新再次触发同一授权码的交换,同时也不会向前端 JavaScript 暴露 API token。

如果必须由 Angular 调用当前 endpoint,后端仍需处理重复请求。可以根据授权码的哈希值、provider、用户或 state 建立唯一记录,并通过数据库唯一约束或事务,保证只有一个请求执行交换。第二个请求可以返回已有的连接状态,也可以明确返回冲突响应,例如 409 Conflict。进程内的 bool 或普通字典无法处理多实例部署,也挡不住多个并发请求。

检查其他常见的重复调用来源

如果项目没有启用 SSR,还需要检查这些位置:

  • 同一个组件是否既通过路由加载,又在其他模板中写了 <app-auth-nylas>。
  • getAuth() 是否也在父组件、resolver、guard、effect 或其他 service 中调用。
  • HTTP interceptor 是否配置了 retry() 或重新订阅。
  • 模板是否调用了返回 HttpClient Observable 的方法。
  • 同一个 Observable 是否存在多个 subscribe() 或多个 async pipe。
  • OAuth 提供方是否发生了两次 callback 导航。
  • 浏览器扩展、自动化测试或开发工具是否调用了该 endpoint。

HttpClient 返回 cold Observable,每次订阅都会发出新的 HTTP 请求:

const request$ = this.dataService.getAuth(code);

request$.subscribe(); // 第一次 POST
request$.subscribe(); // 第二次 POST

如果多个消费者确实需要使用同一个请求结果,可以在合适的作用域中共享结果:

import { shareReplay } from 'rxjs';

const request$ = this.dataService.getAuth(code).pipe(
  shareReplay({ bufferSize: 1, refCount: true })
);

shareReplay() 只能处理同一执行环境中的重复订阅,无法阻止 SSR 和浏览器分别执行,也不能替代后端的幂等保护。

CORS 配置中的注意事项

当前 CORS middleware 已经成功处理预检,通常无需手写 [HttpOptions] action。预检请求一般没有 JSON body,因此下面这个参数并不合适:

[FromBody] AccountCredentials credentials

可以删除整个 Options() action,让 CORS middleware 返回 204:

[ApiController]
[Route("api/[controller]")]
public class AccountConnectController : ControllerBase
{
    [HttpPost]
    public ActionResult<AccountCredentials> Post(
        [FromBody] AccountCredentials credentials)
    {
        Console.WriteLine("Responded to request for account connection");
        return Ok(credentials);
    }
}

日志中还有一条警告:

Failed to determine the https port for redirect.

这表示 UseHttpsRedirection() 没有找到可用的 HTTPS 端口。日志中没有成功的 HTTPS 重定向,因此这条警告与两次 POST 没有直接关系。开发环境仍应正确配置 HTTPS 地址,或者在仅使用 HTTP 的本地配置中调整该 middleware。

根据日志顺序,建议先检查 Angular SSR/hydration。如果浏览器 Network 面板只显示一次 POST,另一条请求就不是浏览器因 CORS 发起的重试。确认来源后,可以用 isPlatformBrowser() 限制前端调用,并在后端为一次性授权码增加原子化的重复请求保护。

备注:内容仅供参考。