Java Web项目常见异常分五类：请求处理、数据库交互、配置加载、并发操作、安全校验；主因是环境配置或资源管理疏忽，定位需优先查看栈顶信息并结合日志。
Java Web项目运行中常见的异常，主要集中在请求处理、数据库交互、配置加载、并发操作和安全校验这五个环节。多数问题并非代码逻辑错误，而是环境、配置或资源管理疏忽导致。定位时优先看异常栈顶信息，再结合日志上下文判断根源。
空指针异常（NullPointerException）
这是Web项目中最频繁出现的异常，尤其在Controller接收参数、Service调用Mapper返回结果、JSP/Thymeleaf渲染对象属性时容易触发。
- 常见场景：前端未传必填参数，后端没判空就直接调用
.toString()或.getXXX() - Mapper查询返回
null，Service层未校验就调用其方法 - Spring MVC自动绑定对象失败（如字段名不匹配），导致注入对象为
null
建议统一使用Objects.requireNonNull()或Optional包装返回值；Controller入参加@NotNull注解配合@Valid校验；MyBatis查询后增加非空判断或改用selectOne + ResultMap明确映射结构。
SQL异常（SQLException / MySQLSyntaxErrorException / DataIntegrityViolationException）
数据库操作出错通常表现为连接失败、SQL语法错误、主键冲突、字段超长、外键约束失败等。
立即学习“Java免费学习笔记（深入）”；
-
Communications link failure：数据库服务宕机、网络不通、连接池耗尽或MySQL wait_timeout超时 -
Column 'xxx' cannot be null：插入数据时非空字段未赋值，或JDBC Type与Java类型不匹配（如把LocalDateTime当String传） -
Deadlock found when trying to get lock：高并发下事务顺序不一致引发死锁
解决方案包括：检查application.yml中数据库URL、用户名密码是否正确；Druid/HikariCP连接池配置testOnBorrow或validationQuery；SQL语句用#{}防注入并确保参数类型与字段一致；对写操作加事务隔离级别控制（如@Transactional(isolation = Isolation.READ_COMMITTED)）。
HTTP状态异常（404 / 405 / 500 / 502）
这些不是Java异常类，但实际开发中常因配置或路由问题暴露为后台报错。
- 404：Spring Boot静态资源路径不对、Controller类没加
@Controller、方法没加@RequestMapping或路径拼写错误 - 405：前端用POST访问了只支持GET的接口，或没配
@PostMapping而默认是GET - 500：后台抛出未捕获异常（如NPE、SQLException），被Spring默认
BasicErrorController转成500页面 - 502：Nginx反向代理时后端Tomcat/Cat未启动，或响应超时未及时返回
建议启用spring.mvc.throw-exception-if-no-handler-found=true让404也走异常处理器；全局定义@ControllerAdvice捕获Exception并返回统一JSON格式错误；Nginx配置proxy_read_timeout与后端超时保持一致。
类加载与配置异常（ClassNotFoundException / NoSuchBeanDefinitionException / IllegalArgumentException）
多出现在项目升级、模块拆分或IDE缓存混乱后。
-
ClassNotFoundException：jar包缺失（如缺mysql-connector-java）、Maven scope设为test导致运行时不可见 -
NoSuchBeanDefinitionException：Service类没加@Service、包扫描路径未覆盖到该类、或构造器注入时依赖bean尚未初始化 -
IllegalArgumentException: Could not resolve placeholder：@Value("${xxx}")对应配置项未在application.yml或@PropertySource中定义
排查方法：用mvn dependency:tree -Dverbose查依赖冲突；确认@SpringBootApplication所在类位于根包；配置文件用${xxx:default_value}提供默认值；启动加--debug查看自动配置报告。
基本上就这些。异常不怕多，怕重复踩坑。养成看栈轨迹第一行、配好全局异常处理器、关键步骤加日志输出的习惯，大部分问题都能快速收敛。
