4-3、新人问问题的正确姿势

"在吗？"
"有个问题想问一下"
"我的项目跑不起来了"
"报错了你帮我看看"

【问题】用户列表接口返回500
【报错信息】java.lang.NullPointerException at UserServiceImpl.java:45
【已排查】
1. 确认userMapper不为null，可以正常调用
2. 断点发现user实体类的deptId为null
3. 数据库里dept_id字段确实有值
【猜测】可能是MyBatis字段映射问题
【问题】deptId在entity里写的deptId，数据库是dept_id，
已经配了map-underscore-to-camel-case，但没生效
【配置】application.yml里mybatis配置截图如下

我在做[功能名称]时遇到一个问题：

【目标】
实现用户列表分页查询

【现象】
访问 GET /api/user/list 返回500

【报错信息】
[粘贴完整错误堆栈]

【相关代码】
[贴出Controller和Service的关键代码]

【已排查】
1. 数据库有数据
2. Mapper可以正常查询
3. 报错在Service层第XX行

【问题】
XXX为null是什么原因？

关于[功能名称]的业务逻辑，有个地方想确认：

【背景】
我在做用户注册功能

【疑问】
注册时需要校验手机号是否已注册，
如果手机号已存在，是返回错误提示还是覆盖更新？

【我的理解】
看代码逻辑是返回错误提示，
但产品文档里写的是"更新已有用户信息"

【问题】
应该以哪个为准？

项目本地启动遇到环境问题：

【目标】
在本地启动admin模块

【报错信息】
[截图或复制完整报错]

【环境信息】
- JDK版本：1.8.0_371
- Maven版本：3.9.6
- MySQL版本：8.0.36
- Redis版本：5.0.14

【已排查】
1. MySQL和Redis服务都在运行
2. 配置文件已改成local环境
3. 依赖没有爆红

【问题】
启动到Nacos连接时报错，
本地是否需要装Nacos？还是可以跳过？

张哥，我在做用户列表分页，遇到个问题。
访问接口返回500，报NullPointerException。
我已经排查了数据库有数据、Mapper能查到，
报错在UserServiceImpl.java:45行。
你方便的时候帮我看下？截图如下：

张哥在吗？
张哥有空吗？
张哥帮我看个问题。
（等了10分钟没回）
张哥？？

❌ "在吗？"
（等回复）
"有个问题想问"

✅ "张哥，我遇到个问题：用户列表接口返回500，
   报错信息是NullPointerException at xxx。
   我排查了数据库和Mapper都没问题，
   你方便的时候帮我看下。"

❌ "我的项目报错了"
   "什么报错？"
   "NullPointerException"
   "在哪报的？"
   "UserServiceImpl"
   "什么操作触发的？"
   "访问用户列表"

✅ "访问用户列表接口返回500，
   报NullPointerException at UserServiceImpl.java:45，
   我排查发现xxx为null，
   你帮我看下是什么原因。"

❌ "Maven依赖爆红怎么解决？"
   （百度第一条就是答案）

✅ "Maven依赖爆红，我试了刷新和删除.lastUpdated文件，
   还是解决不了。我的settings.xml配置如下，
   镜像也配了，你看看是不是哪里配错了。"

❌ 今天问："Maven怎么换镜像？"
   明天问："Maven镜像怎么配？"
   （同一个问题问三遍）

✅ 第一次问完，记下来。下次自己解决。

同事帮你解决了问题，你"哦知道了"，
下次遇到同样的问题又不会了。

✅ 解决后记录下来：
   - 什么问题
   - 怎么解决的
   - 根因是什么
   写在自己的笔记或workbuddy memory里

❌ "这个怎么做？"

✅ "这个功能我想了两种方案：
   方案A：用Redis缓存，优点是xxx，缺点是xxx
   方案B：用本地缓存，优点是xxx，缺点是xxx
   你觉得哪种更合适？"

"原来是这里的问题，我明白了。
 我把解决方案记下来，下次遇到就不用麻烦你了。
 谢谢张哥！"

"哦。"
（什么都没记，下次还问）

"为什么是这样？为什么不那样写？"
（同事花时间帮你解决问题，你还要质疑）

## 2026-01-01 问题记录

### 问题1：用户列表接口返回500
- 原因：User实体类的deptId字段没加@TableField注解
- 解决：加@TableField("dept_id")
- 根因：MyBatis字段映射配置没生效，手动指定列名
- 下次：遇到字段映射问题先检查@TableField注解

### 问题2：Redis连接失败
- 原因：Redis设了密码但配置文件没配password
- 解决：application.yml里加spring.redis.password
- 根因：配置遗漏
- 下次：先redis-cli ping测试Redis连通性