.NET 7中Apple登录重定向异常：跳转至AppleLogin而非/signin-apple

问题描述 #

在.NET 7 Web应用中使用AspNet.Security.OAuth.Apple实现Apple登录功能时，触发认证后可完成登录，但系统未按预期重定向至/signin-apple，反而跳转回AppleLogin Action，导致登录循环。而Facebook、Google等其他登录提供商可正常重定向至对应回调路径（如/signin-facebook、/signin-google）。

现有配置代码 #

Startup.cs 配置片段

.AddApple()
    .Services
    .AddOptions<AppleAuthenticationOptions>(AppleAuthenticationDefaults.AuthenticationScheme)
    .Configure<IConfiguration, IServiceProvider>((options, configuration, serviceProvider) =>
    {
        options.AccessDeniedPath = "/denied";
        options.ClientId = "com.rackemapp.applelogin";
        options.KeyId = "*********";
        options.TeamId = "*********";

        var environment = serviceProvider.GetRequiredService<IHostEnvironment>();
        options.UsePrivateKey(
            keyId =>
                environment.ContentRootFileProvider.GetFileInfo($"/Certs/AuthKey_{keyId}.p8"));

    });

触发登录的Action代码

public IActionResult AppleLogin(string invitecode = null, bool mobile = false)
{
    return Challenge("Apple");
}

排查与解决步骤 #

1. 验证Apple开发者后台的回调URL配置 #

Apple对回调URL有严格的匹配要求，必须满足：

• 使用HTTPS协议（localhost开发环境需通过dotnet dev-certs https生成并信任证书）
• 精确包含你的域名+/signin-apple（例如https://yourdomain.com/signin-apple或https://localhost:5001/signin-apple）
• 登录Apple开发者后台，进入「Certificates, Identifiers & Profiles」，找到对应App ID的「Sign In with Apple」配置，确认「Return URLs」列表包含上述路径。

2. 显式指定Challenge的回调路径 #

修改AppleLogin Action，返回Challenge时通过AuthenticationProperties明确指定回调路径，避免默认值被干扰：

public IActionResult AppleLogin(string invitecode = null, bool mobile = false)
{
    var properties = new AuthenticationProperties
    {
        RedirectUri = "/signin-apple"
    };
    // 如需传递invitecode等参数，可存入Properties后续在回调处理中读取
    if (!string.IsNullOrEmpty(invitecode))
    {
        properties.Items["invitecode"] = invitecode;
    }
    properties.Items["mobile"] = mobile.ToString();
    
    return Challenge(properties, "Apple");
}

3. 确认认证配置未覆盖默认回调路径 #

检查AppleAuthenticationOptions配置，确保未手动修改CallbackPath，默认情况下中间件会使用/signin-apple，自定义路径会导致与Apple后台配置不匹配：

// 确保配置中不存在这一行，或设置为正确的回调路径
// options.CallbackPath = "/custom-callback";

4. 避免MVC路由拦截回调路径 #

确保项目路由配置中，没有自定义路由捕获/signin-apple路径。该路径由Apple认证中间件处理，无需在MVC中定义对应的Action。

5. 检查中间件注册顺序 #

确保认证中间件在MVC中间件之前注册，保证回调路径能被正确处理：

app.UseAuthentication();
app.UseAuthorization();

// 之后注册MVC路由
app.MapControllerRoute(
    name: "default",
    pattern: "{controller=Home}/{action=Index}/{id?}");

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