Angular 19 向 .NET Core 9 后端重复发送 POST 请求
结论
OPTIONS 预检请求不会触发第二次 POST,ASP.NET Core 的 CORS middleware 也不会把 OPTIONS 转成 POST。
从日志看,这两次 POST 很可能来自不同的执行环境:
- 第一个
POST没有Origin请求头,也没有对应的预检请求。 - 第二个
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 回调设计
一次性授权码更适合交给后端处理。常见流程如下:
- OAuth 提供方将用户重定向到后端 callback。
- 后端验证
state。 - 后端使用授权码交换 token。
- token 保存在服务端,或通过安全的
HttpOnlycookie 建立会话。 - 后端将用户重定向到不含授权码的 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()或重新订阅。 - 模板是否调用了返回
HttpClientObservable 的方法。 - 同一个 Observable 是否存在多个
subscribe()或多个asyncpipe。 - 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() 限制前端调用,并在后端为一次性授权码增加原子化的重复请求保护。
备注:内容仅供参考。
