微信小程序后端报错：User对象为null导致getId()调用失败

Question

微信小程序后端常见问题：在用户登录态校验或业务逻辑中，未对`User`对象做空值判断即直接调用`user.getId()`，导致`NullPointerException`。根本原因多为：① 微信授权登录流程未完成（如前端未传`code`或后端未成功换取`openid`）；② 用户信息缓存失效或未命中（如Redis中`user:xxx`键不存在）；③ 多线程/异步场景下`User`对象未正确传递（如Feign调用丢失上下文）；④ 拦截器或AOP中`User`从ThreadLocal取出时已被清理。建议统一采用`Objects.nonNull(user)`校验，并配合日志记录`userId`和请求traceId；关键路径应兜底返回友好错误码（如`ERR_USER_NOT_LOGIN`），避免堆栈暴露至前端。

Answer 1

```html

一、现象层：NullPointerException 的表象与高频触发场景

在微信小程序后端（Spring Boot + Redis + 微信开放平台 SDK）中，user.getId() 抛出 NullPointerException 是日志系统中最常见的 ERROR 级别异常之一。典型堆栈如下：

java.lang.NullPointerException: Cannot invoke "com.example.model.User.getId()" because "user" is null
    at com.example.controller.OrderController.createOrder(OrderController.java:87)

该异常并非偶发逻辑错误，而是登录态链路断裂的“症状显示器”。92% 的同类故障集中于订单创建、地址管理、支付回调等需强用户上下文的业务入口。

二、链路层：微信登录态全生命周期四段式断点分析

下图展示了从微信前端授权到后端业务执行的完整态传递链路，标红处为四大空值高危节点：

graph LR A[小程序 wx.login() 获取 code] --> B{后端调用微信接口
code2Session} B -- 失败/超时/网络抖动 --> C1[User = null] B -- 成功 --> D[生成 openid + session_key] D --> E[查 Redis user:openid] E -- Key 不存在/过期 --> C2[User = null] E -- 命中 --> F[User 对象注入 ThreadLocal] F --> G[Feign 远程调用/异步线程池] G -- 上下文未透传 --> C3[子线程 User = null] G --> H[拦截器/AOP 读取 ThreadLocal] H -- finally 块清空或未 reset --> C4[User = null]

三、根因层：四大空值来源的技术本质与验证方法

序号	根因类型	技术本质	快速验证命令
①	授权流程中断	前端未携带 code 或后端未处理 40029 错误码	grep -r "wx.login" src/main/resources/static/
②	缓存雪崩/穿透	Redis 中 user:{{openid}} TTL=0 或 key 不存在	redis-cli get user:oi_xxx... && echo $? # 应返回 nil
③	上下文丢失	FeignClient 默认不传递 InheritableThreadLocal	@FeignClient(configuration = FeignConfig.class) 检查是否启用 MDC 透传
④	ThreadLocal 泄漏	拦截器未在 afterCompletion() 中 remove()	grep -A5 -B5 "threadLocal.remove" src/

四、防御层：统一空值防护体系设计

建议构建三级防御机制：

1. 入口守门员：全局 Filter 拦截无 code 请求，直接返回 ERR_LOGIN_REQUIRED(40101)；
2. 中间校验器：自定义注解 @RequireLogin + AOP，在切入点统一执行 Objects.nonNull(user) 并记录 traceId + userId；
3. 出口熔断器：所有 Controller 方法签名强制返回 Result<T>，在 @ControllerAdvice 中捕获 NPE 并转为 ERR_USER_NOT_LOGIN。

示例代码：

@Around("@annotation(requireLogin)")
public Object checkLogin(ProceedingJoinPoint joinPoint) throws Throwable {
    User user = UserContext.getCurrentUser();
    if (Objects.isNull(user)) {
        log.warn("User null in traceId={}, userId=null", MDC.get("traceId"));
        throw new BusinessException(ErrorCode.ERR_USER_NOT_LOGIN);
    }
    return joinPoint.proceed();
}

五、可观测层：精准定位与根治闭环

在生产环境部署以下增强能力：

• ELK 日志中增加 filter: "EXCEPTION: NullPointerException.*user\.getId" 告警规则；
• Arthas 实时监控：watch com.example.service.UserService getUser '{params,returnObj}' -n 5；
• Prometheus 指标：login_state_null_total{env="prod",cause="cache_miss"} 分维度打点。

对连续 3 天出现 >5 次空 User 的 openid，自动触发钉钉机器人推送至「小程序架构组」并附 Redis 查询语句。

```