.NET WebApi生产环境登录注册失效问题排查

核心排查点及验证步骤 #

1. JWT配置缺失或错误 #

登录逻辑中CreateJWT(user)方法生成Token依赖的配置，在生产环境可能未正确设置：

• 检查生产环境appsettings.json中的JWT节点，确认Issuer、Audience、SecretKey等参数完整且有效，避免开发环境仅在appsettings.Development.json中配置而生产环境遗漏。
• 验证CreateJWT方法是否对配置参数做了空值判断，防止因配置缺失抛出未捕获异常。

2. 数据库连接异常 #

开发与生产环境数据库配置不同，可能导致查询失败：

• 核对生产环境数据库连接字符串的服务器地址、用户名、密码、库名是否正确。
• 确认生产服务器具备数据库访问权限（防火墙规则是否开放端口、数据库用户是否有查询权限）。
• 注意uow.UserRepository.Authenticate方法在查询过程中可能抛出连接超时、权限不足等异常，而非仅返回null。

3. 依赖注入或服务初始化问题 #

生产环境的服务注册逻辑可能存在偏差：

• 检查Program.cs/Startup.cs中uow（工作单元）、UserRepository的注册代码，确保生命周期、实例化逻辑与开发环境一致。
• 确认UserRepository依赖的其他服务（如加密工具）在生产环境已正确注册并初始化。

4. 日志缺失导致无法定位异常 #

生产环境默认关闭详细错误输出，需主动捕获日志：

• 配置日志框架（如Serilog、NLog）记录接口异常信息，重点捕获Login方法内未处理的异常。
• 临时在生产环境appsettings.json中设置"DetailedErrors": true，获取具体错误详情（调试完成后关闭，避免泄露敏感信息）。

5. 请求参数模型绑定失败 #

前端请求参数与后端模型可能存在不匹配：

• 检查前端loginForm.value的字段名是否与后端loginReqDto属性名完全一致（注意大小写敏感，比如后端UserName与前端userName可能导致绑定失败）。
• 用Postman直接调用生产环境接口，模拟前端请求，排除前端参数传递问题。

6. 密码哈希验证不兼容 #

Authenticate方法中的密码哈希逻辑在生产环境可能失效：

• 确认生产环境使用的哈希算法（如PasswordHasher、SHA256）与开发环境一致，盐值配置无差异。
• 检查生产数据库中存储的密码哈希格式是否与开发环境匹配。

相关代码参考 #

后端Account Controller登录代码 #

[HttpPost("login")]
public async Task<IActionResult> Login(loginReqDto loginReq)
{
    var user = await uow.UserRepository.Authenticate(loginReq.UserName, loginReq.Password);

    ApiError apiError = new ApiError();

    if(user == null)
    {
        apiError.ErrorCode = Unauthorized().StatusCode;
        apiError.ErrorMessage = "Invalid userId or Password!";
        apiError.ErrorDetails = "This is appearing when user or password does not exist!";
        return Unauthorized(apiError);
    }

    var loginRes = new LoginResDto();
    loginRes.UserName = user.Username;
    loginRes.Token = CreateJWT(user);
    return Ok(loginRes);
}

前端Angular登录代码 #

onlogin(loginForm: NgForm){

console.log(loginForm.value);
this.authServive.authUser(loginForm.value).subscribe(      
  (response: any) => {
    console.log(response);
    const user = response;
    localStorage.setItem('token', user.token);
    localStorage.setItem('userName', user.userName);
    this.alertify.success("You have loged-in successfully!");
    this.router.navigate(['/']);
  });
}

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