基于SSM+JSP的流浪猫狗信息管理系统设计与实现-代码聚汇网

先交代一下背景：这篇文章是拿“Java基于SSM+JSP的流浪猫狗信息管理系统的设计与实现”这个题目来做的。这个题目在毕业设计、课程设计里出现的频率非常高，几乎可以算Java Web方向的“经典款”。它不追求多高深的技术，而是把SSM三大框架、JSP页面渲染、数据库设计、权限控制这些核心能力完完整整串了一遍。如果你正在做类似的选题，或者想通过一个完整项目把SSM+JSP从“背八股”变成“真实落地”，这篇文章应该能帮上不少忙。

我自己做这个系统的时候踩了不少坑，尤其是JSP和SSM混合开发时那些“看似简单却绕不过去”的细节。下面会从设计思路、技术拆解、编码实现、问题排查四个角度展开，尽量把项目还原到可以直接照着做的程度。

1. 整体设计与思路拆解

1.1 为什么SSM+JSP依然是值得做的组合

先说结论：SSM+JSP在今天依然是一个“不过时、但也很经典”的技术组合。Spring负责对象管理和事务，SpringMVC负责请求路由和参数绑定，MyBatis负责数据库访问，JSP负责服务端页面渲染。这套组合的最大特点就是“分工明确、层层递进”，每个环节都能找到独立的关注点，非常适合用来理解Java Web的完整请求链路。

对比现在流行的Spring Boot+Vue前后端分离方案，SSM+JSP确实显得“老”，但它也有不可替代的优势：JSP在服务端渲染，天然适合SEO，不用解决跨域问题，部署也简单——一个WAR包丢到Tomcat就能跑。对于信息发布、后台管理这类系统，服务端渲染反而比前后端分离更省事。更重要的是，很多公司在维护老项目时用的还是这套技术栈，你掌握它，面试和工作中都不会吃亏。

1.2 系统需求与功能模块拆解

流浪猫狗信息管理系统本质上是一个“信息发布+业务流转”的平台。它的核心用户有三类：普通游客、注册用户（救助者/领养者）、管理员。对应到业务上，核心链路是：救助者发现流浪动物→登记信息→平台展示→领养者浏览→提交领养申请→管理员审核→反馈结果。

功能模块大致可以分为前台展示和后台管理两块：

功能模块	角色	核心功能点
首页展示	游客/用户	流浪动物卡片列表、公告、筛选
动物详情	游客/用户	详细信息、图片、救助故事、留言
领养申请	注册用户	提交申请、填写领养理由、查看进度
救助登记	注册用户	发布流浪猫狗信息、上传照片
个人中心	注册用户	我的申请、我的发布、资料修改
后台管理	管理员	用户管理、动物信息审核、领养审核、公告管理

做这个系统最忌讳的就是“上来就写代码”。我当时先画了角色用例图和数据流图，把每个角色的操作边界理清楚，再动手建表。比如“领养申请”这个状态，至少要经历“待审核→通过/驳回→已完成”这几个节点，每个节点对应不同的操作权限和页面展示，这些在设计阶段就要想清楚。

1.3 数据库设计的核心思路

数据库是这类系统的命根子。我的建议是表不要太多，但每张表的字段要贴合真实业务。核心表有：用户表、动物信息表、领养申请表、救助记录表、公告表、留言表。

以用户表和动物信息表为例，字段设计上有几个容易踩坑的点：

用户表的密码字段不要用varchar(50)直接存明文，至少用MD5加密，字段长度设64位，为以后换加密算法留余地。
动物信息表要单独存“状态”字段，比如0=待审核、1=展示中、2=已领养、3=已下架，不要用删除来代表下架，否则数据审计很麻烦。
图片路径统一存相对路径（如/upload/animal/20250101.jpg），不要存完整URL，方便以后换域名或者迁移。
所有表都加上create_time和update_time字段，排查数据问题的时候会省很多时间。

外键我用的是逻辑外键而不是物理外键。比如领养申请表里的user_id关联用户表，不在数据库层面加FOREIGN KEY约束，而是在Service层做校验。原因是物理外键在高并发插入和删除时容易造成锁竞争，而且后期分库分表几乎没法改。面试时如果被问到“为什么不用物理外键”，这也是一个很加分的回答点。

需要模型API调用？免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。

2. 核心技术细节解析

2.1 Spring容器如何管理整个项目的“零件”

Spring的核心是IOC（控制反转）和AOP（面向切面）。不理解这两个概念，SSM框架就永远是“能用但说不清”。用生活化类比来说：传统开发中，你需要某个Service对象时，自己new一个；而Spring像个智能仓库，你只管声明“我要什么”，它把创建好的对象递给你，这就是控制反转。

在一个SSM项目中，Spring容器负责管理Service、Mapper这些Bean。Service里Autowired注入Mapper，Controller里Autowired注入Service。这种依赖注入的好处是各层之间解耦，替换实现类时不用改调用方代码。

AOP在这个系统里最典型的应用是事务管理。领养审核这个操作涉及两步：更新申请状态、更新动物状态。如果第二步执行失败，第一步已经改了数据，就会出现脏数据。用Spring声明式事务，在Service方法上加@Transactional注解，只要方法内部抛出RuntimeException，整个事务就回滚了。我建议你把事务边界控制在Service层，不要在Controller层加事务——Controller的职责只是接收参数和返回视图，一旦加了事务，请求线程会被事务占住，并发高的时候很容易拖垮数据库连接池。

2.2 SpringMVC的请求处理链路

SpringMVC的处理流程可以用一句话概括：前端控制器DispatcherServlet接收请求→HandlerMapping找到对应Controller方法→Controller执行业务逻辑→ModelAndView交给ViewResolver解析→返回JSP页面。

在JSP项目中，我会特别注意Model对象的传递方式。Controller里return "animal/list"，同时往model里setAttribute("animalList", list)，JSP页面用EL表达式${animalList}就能取到数据。这里有个细节：如果return的字符串里带redirect:前缀，如return "redirect:/animal/list"，浏览器会发出一次新的GET请求，适合增删改操作后刷新列表，防止F5重复提交。

拦截器（Interceptor）也是SpringMVC一个不可忽视的组件。登录校验、管理员权限校验都可以做成拦截器，在preHandle方法里判断session是否存在用户，不存在就重定向到登录页。拦截器配置在springmvc.xml里，注意拦截路径要写成/manager/**这样的模式，同时要exclude掉登录接口和静态资源。

2.3 MyBatis映射与动态SQL的关键点

MyBatis的核心是Mapper接口与XML映射文件的绑定。一个最常见的坑是：接口方法名和XML里的statement id不一致，启动时不报错，一调用就报Invalid bound statement。排查思路是检查命名空间是否等于接口全限定名，方法名是否一致，参数类型是否匹配。

动态SQL是MyBatis的杀手锏。比如动物列表的筛选条件经常是可变的：按品种查、按状态查、按发布时间查，每个条件都可能为空。用标签配合判断，就能拼出不同SQL，比用StringBuilder拼SQL安全一万倍，彻底告别SQL注入。

resultMap也要单独说一下。如果数据库字段是snake_case（如create_time），而实体类是驼峰命名（createTime），可以在mybatis-config.xml里设置mapUnderscoreToCamelCase为true，这样就不用每个字段都写resultMap了。但对于多表联查的结果，比如领养申请列表要关联用户姓名和动物名称，最好还是单独建VO类，用resultMap做自定义映射。

2.4 JSP+JSTL/EL的页面渲染方式

JSP不是简单的“HTML里写Java代码”，它有自己的规范。我比较推荐的做法是：JSP页面里不出现Java代码，只用JSTL标签和EL表达式。比如循环遍历动物列表：

jsp复制<c:forEach items="${animalList}" var="animal">
    <div class="card">
        <img src="${animal.coverImage}" alt="${animal.name}">
        <h3>${animal.name}</h3>
        <p>${animal.breed} · ${animal.age}岁</p>
        <a href="${pageContext.request.contextPath}/animal/detail/${animal.id}">查看详情</a>
    </div>
</c:forEach>

EL表达式的优势是自动处理null值，不用像Java代码那样频繁判空。JSTL标签库中c:forEach、c:if、c:choose这三个用得最多，fmt:formatDate用于格式化时间，fn:substring用于截断过长的字符串。

JSP有个需要特别注意的地方：页面顶部的<%@ page contentType="text/html;charset=UTF-8" language="java" %>这句必须写，不然中文大概率乱码。另外，静态资源（CSS、JS、图片）建议统一放在webapp/static目录下，页面引用时用${pageContext.request.contextPath}拼路径，绝对不要写死相对路径，否则请求路径一深就找不到资源。

3. 实操过程与核心环节实现

3.1 开发环境与工程结构准备

做这个系统我推荐的环境组合是：

工具	版本	用途
JDK	1.8	Java运行环境
Maven	3.6+	依赖管理、构建
Tomcat	8.5	Web容器
MySQL	5.7/8.0	数据库
IDEA	任意版本	开发工具

JDK版本我刻意选1.8，因为SSM框架对旧版本兼容性最好，很多老教程也是基于1.8写的，遇到问题好搜解决方案。如果你本机装的是JDK 17，IDEA编译时经常报“源发行版17需要目标发行版17”，这个其实是Maven编译插件版本和JDK版本不匹配，后面第4章会详细说。

工程结构上，我建议按Maven标准目录创建：

text复制src/main/java
├── com.xxx.catdog
│   ├── controller
│   ├── service
│   │   └── impl
│   ├── mapper
│   ├── entity
│   ├── vo
│   └── interceptor
src/main/resources
├── mybatis
│   └── mapper
├── spring
│   ├── spring-mvc.xml
│   ├── applicationContext.xml
│   └── jdbc.properties
src/main/webapp
├── static
│   ├── css
│   ├── js
│   └── images
├── WEB-INF
│   ├── views
│   └── web.xml

分包的核心逻辑是“按层分包、按关注点聚合”。controller只做参数接收和视图转发，service只做业务逻辑，mapper只做数据访问。这样分工明确，后期加功能、改bug都能快速定位。

3.2 Maven依赖配置与pom.xml示例

Maven依赖是SSM项目最容易出问题的环节。依赖版本冲突、jar包缺失、传递依赖拉错版本，都是家常便饭。下面是我在项目中实测稳定的一套依赖组合：

xml复制<properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <spring.version>5.3.20</spring.version>
</properties>

<dependencies>
    <!-- Spring核心 -->
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-context</artifactId>
        <version>${spring.version}</version>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-webmvc</artifactId>
        <version>${spring.version}</version>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-jdbc</artifactId>
        <version>${spring.version}</version>
    </dependency>

    <!-- MyBatis整合Spring -->
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.5.11</version>
    </dependency>
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis-spring</artifactId>
        <version>2.0.7</version>
    </dependency>

    <!-- MySQL驱动 -->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>5.1.49</version>
    </dependency>

    <!-- 数据库连接池 -->
    <dependency>
        <groupId>com.alibaba</groupId>
        <artifactId>druid</artifactId>
        <version>1.2.8</version>
    </dependency>

    <!-- JSP相关 -->
    <dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>jstl</artifactId>
        <version>1.2</version>
    </dependency>
    <dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>javax.servlet-api</artifactId>
        <version>3.1.0</version>
        <scope>provided</scope>
    </dependency>

    <!-- 其他工具 -->
    <dependency>
        <groupId>cn.hutool</groupId>
        <artifactId>hutool-all</artifactId>
        <version>5.8.10</version>
    </dependency>
</dependencies>

两个容易踩的坑：一是servlet-api和jsp-api的scope一定要是provided，因为Tomcat自带了这些类，不加provided会把Tomcat的类覆盖掉，启动时各种诡异报错；二是MySQL 8.x版本需要把驱动类从com.mysql.jdbc.Driver改成com.mysql.cj.jdbc.Driver，并且URL要加serverTimezone=Asia/Shanghai参数，否则插入时间会差8小时。

3.3 核心配置文件与SpringMVC/MyBatis整合

SSM整合的难点在配置，配置的核心在springmvc.xml和applicationContext.xml。我的分法是：springmvc.xml只管Controller层相关的组件扫描、注解驱动、视图解析器、拦截器；applicationContext.xml管Service层、Mapper层、数据源和事务。两个配置文件通过web.xml的contextConfigLocation加载，避免互相污染。

springmvc.xml的核心配置：

xml复制<context:component-scan base-package="com.xxx.catdog.controller"/>

<mvc:annotation-driven/>

<bean id="viewResolver"
      class="org.springframework.web.servlet.view.InternalResourceViewResolver">
    <property name="prefix" value="/WEB-INF/views/"/>
    <property name="suffix" value=".jsp"/>
</bean>

<mvc:resources mapping="/static/**" location="/static/"/>

<mvc:interceptors>
    <mvc:interceptor>
        <mvc:mapping path="/user/**"/>
        <mvc:exclude-mapping path="/user/login"/>
        <mvc:exclude-mapping path="/user/register"/>
        <bean class="com.xxx.catdog.interceptor.LoginInterceptor"/>
    </mvc:interceptor>
</mvc:interceptors>

这里有个非常关键的点：mvc:resources这行必须配，如果你用了静态资源不放到Tomcat默认的servlet去处理，SpringMVC会把CSS、JS的请求也当作Controller映射来查找，结果就是页面有结构但没有任何样式。很多新手做SSM项目做的页面“裸奔”，十有八九是这里漏了。

applicationContext.xml里重点是数据源和SqlSessionFactory：

xml复制<context:property-placeholder location="classpath:jdbc.properties"/>

<bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource">
    <property name="driverClassName" value="${jdbc.driver}"/>
    <property name="url" value="${jdbc.url}"/>
    <property name="username" value="${jdbc.username}"/>
    <property name="password" value="${jdbc.password}"/>
</bean>

<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
    <property name="dataSource" ref="dataSource"/>
    <property name="mapperLocations" value="classpath:mybatis/mapper/*.xml"/>
    <property name="typeAliasesPackage" value="com.xxx.catdog.entity"/>
    <property name="configuration">
        <bean class="org.apache.ibatis.session.Configuration">
            <property name="mapUnderscoreToCamelCase" value="true"/>
        </bean>
    </property>
</bean>

<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
    <property name="basePackage" value="com.xxx.catdog.mapper"/>
</bean>

<bean id="transactionManager"
      class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
    <property name="dataSource" ref="dataSource"/>
</bean>
<tx:annotation-driven transaction-manager="transactionManager"/>

mapperLocations这行尤其重要。如果你的Mapper XML文件没放到resources目录下，而是放到了src/main/java里，Maven默认不会把它们打进classes目录，运行时就报“Invalid bound statement”。解决办法是在pom.xml的build节点里加resources配置，把src/main/java下的xml文件也打包进去。这个坑我当年查了一整天才找到原因。

3.4 领养申请功能的完整编码链路

领养申请是这个系统的核心业务，我把它完整演示一遍，你可以直接照着抄。先看Controller层：

java复制@Controller
@RequestMapping("/adopt")
public class AdoptController {

    @Autowired
    private AdoptService adoptService;

    /**
     * 提交领养申请
     */
    @PostMapping("/apply")
    public String apply(AdoptApplyVO vo, HttpSession session) {
        User user = (User) session.getAttribute("loginUser");
        if (user == null) {
            return "redirect:/user/login";
        }
        // 防止重复申请：同一用户对同一动物只能有一条待审核记录
        int count = adoptService.countPendingApply(user.getId(), vo.getAnimalId());
        if (count > 0) {
            return "redirect:/animal/detail/" + vo.getAnimalId() + "?error=repeated";
        }
        vo.setUserId(user.getId());
        adoptService.submitApply(vo);
        return "redirect:/user/myApply";
    }
}

Service层负责业务逻辑和事务控制：

java复制@Service
public class AdoptServiceImpl implements AdoptService {

    @Autowired
    private AdoptApplyMapper adoptApplyMapper;
    @Autowired
    private AnimalInfoMapper animalInfoMapper;

    @Transactional(rollbackFor = Exception.class)
    @Override
    public void submitApply(AdoptApplyVO vo) {
        AdoptApply apply = new AdoptApply();
        BeanUtils.copyProperties(vo, apply);
        apply.setStatus(0); // 0=待审核
        apply.setCreateTime(new Date());
        adoptApplyMapper.insert(apply);

        // 申请提交后，动物状态改为“申请中”，避免其他人重复申请
        animalInfoMapper.updateStatus(vo.getAnimalId(), 4);
    }
}

Mapper接口：

java复制public interface AdoptApplyMapper {
    int insert(AdoptApply record);
    int countPendingApply(@Param("userId") Integer userId, @Param("animalId") Integer animalId);
    List<AdoptApplyVO> selectApplyList(@Param("status") Integer status);
}

对应的XML：

xml复制<insert id="insert" parameterType="com.xxx.catdog.entity.AdoptApply">
    insert into adopt_apply(user_id, animal_id, reason, status, create_time)
    values(#{userId}, #{animalId}, #{reason}, #{status}, #{createTime})
</insert>

<select id="countPendingApply" resultType="int">
    select count(*) from adopt_apply
    where user_id = #{userId}
      and animal_id = #{animalId}
      and status = 0
</select>

<select id="selectApplyList" resultType="com.xxx.catdog.vo.AdoptApplyVO">
    select a.*, u.username, u.phone, ai.name as animalName, ai.cover_image as animalImage
    from adopt_apply a
    left join users u on a.user_id = u.id
    left join animal_info ai on a.animal_id = ai.id
    <where>
        <if test="status != null">
            and a.status = #{status}
        </if>
    </where>
    order by a.create_time desc
</select>

这段代码里有几个值得注意的设计细节。一是用状态字段而不是删除记录来标记“申请中”，方便追溯历史；二是采用逻辑外键关联，在SQL查询时用LEFT JOIN去补全显示字段，而不是把用户和动物的完整信息冗余存在申请表里；三是在Service层做“重复申请校验”，这比在Controller层做更安全，因为Service层可以被多个Controller方法或者将来的REST接口复用。

3.5 图片上传与虚拟目录映射

流浪动物信息发布必然涉及图片上传。SSM项目里上传图片的推荐做法是：把图片保存到本地磁盘目录（比如/usr/local/upload/），然后通过Tomcat的虚拟目录映射到/upload/**，这样JSP页面用就能访问。

上传代码用commons-fileupload实现，先在springmvc.xml配置：

xml复制<bean id="multipartResolver"
      class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
    <property name="maxUploadSize" value="10485760"/>
    <property name="defaultEncoding" value="UTF-8"/>
</bean>

Controller里接收MultipartFile：

java复制@PostMapping("/publish")
public String publish(AnimalInfo animalInfo,
                      @RequestParam("coverFile") MultipartFile coverFile,
                      HttpServletRequest request) throws IOException {
    if (!coverFile.isEmpty()) {
        String realPath = request.getServletContext().getRealPath("/");
        // 项目同级目录的upload文件夹，避免部署目录重启丢失
        String uploadDir = realPath.substring(0, realPath.lastIndexOf(File.separator))
                + File.separator + "upload";
        File dir = new File(uploadDir);
        if (!dir.exists()) {
            dir.mkdirs();
        }
        String originalFilename = coverFile.getOriginalFilename();
        String ext = originalFilename.substring(originalFilename.lastIndexOf("."));
        String newName = System.currentTimeMillis() + "_" + UUID.randomUUID().toString().substring(0, 8) + ext;
        coverFile.transferTo(new File(uploadDir + File.separator + newName));
        animalInfo.setCoverImage("/upload/" + newName);
    }
    animalInfoService.publish(animalInfo);
    return "redirect:/animal/list";
}

上传文件的保存路径是新手最容易迷糊的地方。直接把文件写到Tomcat部署目录/webapps/项目名/upload下看似方便，但项目每次重新部署时文件就没了。我的做法是把上传目录提升到Tomcat上一级目录，然后通过server.xml的Context配置做虚拟目录映射（开发时也可以在IDEA的Tomcat配置里加Deployment的External Source），这样即使重打WAR包，上传的图片也还在。文件名一定不能用用户上传的原始名，否则重名覆盖、中文乱码、路径穿越都是问题，改成“时间戳+UUID+后缀”是通用做法。

3.6 分页查询与模糊搜索实现

动物列表的分页查询我推荐使用PageHelper插件，几行代码就能搞定分页，不用手动拼LIMIT。

java复制@Service
public class AnimalServiceImpl implements AnimalService {

    @Autowired
    private AnimalInfoMapper animalInfoMapper;

    @Override
    public PageInfo<AnimalInfoVO> queryPage(AnimalQueryVO queryVO) {
        PageHelper.startPage(queryVO.getPageNum(), queryVO.getPageSize());
        List<AnimalInfoVO> list = animalInfoMapper.selectByCondition(queryVO);
        return new PageInfo<>(list);
    }
}

Mapper XML里用动态SQL拼条件：

xml复制<select id="selectByCondition" resultType="com.xxx.catdog.vo.AnimalInfoVO">
    select a.*, u.username as publisherName
    from animal_info a
    left join users u on a.publisher_id = u.id
    <where>
        <if test="keyword != null and keyword != ''">
            and (a.name like concat('%', #{keyword}, '%')
                 or a.breed like concat('%', #{keyword}, '%'))
        </if>
        <if test="status != null">
            and a.status = #{status}
        </if>
        <if test="category != null and category != ''">
            and a.category = #{category}
        </if>
    </where>
    order by a.create_time desc
</select>

注意like语句不要写成'%#{keyword}%'，这样在预编译的时候会报错，正确写法是用concat函数拼接。这也是面试中常考的点：MyBatis预编译参数占位符不能出现在字符串字面量内部，concat才是标准解决方式。PageHelper插件有一个坑，就是它只对紧跟着的第一条SQL生效，所以startPage调用之后必须马上接Mapper查询，中间不能有其他的SQL操作，否则分页参数可能会错位到别的查询上。

3.7 登录拦截与权限分级管理

权限管理我采用“两级控制”：用户登录拦截 + 管理员权限校验。登录拦截器负责检查session里有没有loginUser对象，没有就重定向到登录页；管理员检查loginUser的role字段是不是1，不是就返回403页面。

java复制public class LoginInterceptor implements HandlerInterceptor {

    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response,
                             Object handler) throws Exception {
        HttpSession session = request.getSession();
        User user = (User) session.getAttribute("loginUser");
        if (user == null) {
            // AJAX请求返回状态码，普通请求重定向
            String requestedWith = request.getHeader("X-Requested-With");
            if ("XMLHttpRequest".equals(requestedWith)) {
                response.setStatus(401);
                return false;
            }
            response.sendRedirect(request.getContextPath() + "/user/login");
            return false;
        }
        return true;
    }
}

AdministratorInterceptor和LoginInterceptor的区别只是在登录校验通过后多判断一层role字段。这里又引出一个设计决策：session里存的User对象要不要包含角色字段。我的建议是登录查询时就把role字段查出并放到session里，业务中随时可读，不用每次都查库。对于这个规模的项目，把角色和登录状态放在session足够；如果你想把角色权限做得更细（比如管理员也要区分超级管理员和普通运营），就要引入Spring Security或者Shiro，但技术复杂度会明显提升，课程设计阶段不建议一上来就上安全框架。

4. 常见问题与排查技巧实录

4.1 环境与编译类问题速查

做SSM项目第一个遇到的坑往往不是代码问题，而是本地环境问题。我最常被问到的几个，整理成速查表格：

问题现象	根本原因	解决方式
IDEA编译报“源发行版17需要目标发行版17”	Maven编译器插件默认的source/target和本机JDK版本不匹配	pom.xml中显式设置maven.compiler.source/target为1.8
Lombok注解不生效，编译报找不到getter/setter	Lombok版本和JDK版本不兼容	升级Lombok到1.18.30+，或排查annotation processing是否开启
启动Tomcat提示端口被占用	上次未正常关闭或heep映射端口冲突	命令行netstat -ano
Maven依赖一直下载失败	网络问题或私服地址不可达	换阿里云镜像源，或把settings.xml的mirror配置改一下

具体到“源发行版17需要目标发行版17”这个问题，本质是你本机装了JDK 17，但IDEA的Project Structure里Project SDK选择的是17，而Maven compiler插件默认用JDK17的release模式，最终需要目标发行版17。如果你打算用JDK 8编译，就在pom.xml里显式声明：

xml复制<properties>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
</properties>

或者更保险的写法是直接配maven-compiler-plugin：

xml复制<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.8.1</version>
            <configuration>
                <source>1.8</source>
                <target>1.8</target>
            </configuration>
        </plugin>
    </plugins>
</build>

同时确认IDEA右下角的小人头图标里的“SDK”和“Language Level”保持统一。很多“代码没问题但就是编译不过”的情况，最后都是SDK配置混乱导致的——IDEA的Project Structure、Maven设置、pom.xml三处的Java版本其实只要有一处不一致就会报错。

4.2 Spring容器与MyBatis绑定类问题

SSM项目启动时最常见的报错是“No qualifying bean of type”，翻译过来就是Spring容器里找不到你要注入的Bean。这类问题分三种：

Service类没加@Service注解，或者component-scan扫描的包路径不对。
Mapper接口没有被MapperScannerConfigurer扫描到，检查basePackage是否写成了具体类而不是包路径。
Mapper XML没有绑定到接口，检查namespace是否等于接口全限定名，statement id是否等于方法名。

“Invalid bound statement (not found)”这个报错在SSM里尤其恼人，因为很多情况下启动不报错，点某个功能才报。我的排查思路是三步走：第一检查target/classes目录下有没有对应的XML文件——这一步能过滤掉Maven打包时漏掉XML的情况；第二检查namespace和方法名；第三看接口方法是否有@Param注解但XML里没用对应名称。

另外还有一个静态资源相关的坑：如果打开页面发现CSS、JS全部加载不出来，F12看到请求返回的都是404，基本就是DispatcherServlet把静态资源请求拦截了。解决方式是前面提到的mvc:resources配置。如果你使用的是更高一点的Spring 5，可以改用WebMvcConfigurer里的addResourceHandlers，但SSM老项目里mvc:resources才是最稳的。

4.3 JSP页面的中文乱码与路径问题

JSP中文乱码是另一个高频问题，涉及三个环节：

页面本身要设置charset=UTF-8，包括<%@ page contentType="text/html;charset=UTF-8" %>和。
提交表单的POST请求，要在web.xml里配置CharacterEncodingFilter，且顺序尽量靠前。
数据库连接URL要加useUnicode=true&characterEncoding=UTF-8，MySQL表编码也要是utf8mb4。

如果这三处都对了但还是乱码，就要重点排查过滤器的顺序。CharacterEncodingFilter必须配置在所有Filter最前面，因为SpringMVC的请求参数解析发生在后面，如果参数已经被错误地按ISO-8859-1解码了，后面再设置编码也来不及。

跳转路径问题也值得专门说一次。JSP页面里链接和表单的action，尽量不要写/animal/list这种不带项目上下文的路径。因为部署后项目路径通常带一个上下文名（比如http://localhost:8080/catdog/），response.sendRedirect时如果没加contextPath，就会跳转到根路径下，直接404。最好的习惯是统一使用${pageContext.request.contextPath}来拼路径。

4.4 性能与设计类问题优化建议

很多同学做完系统后发现列表页刷新很慢，或者Tomcat频繁内存溢出，常见的原因有几个：

第一是N+1查询问题。例如动物列表中每条记录都要另外查一次发布者信息，100条数据就要查101次库。解决方式是改造成JOIN查询，把需要展示的关联字段一次性查出来。

第二是图片没有做压缩或统一尺寸。流浪动物照片来自用户上传，原始照片可能有几MB，浏览器一张张加载自然很慢。当时我的优化方式是：上传时用JDK自带的ImageIO做等比例压缩，限制最长边不超过800px，再转成jpg格式存储，页面加载速度提升了不止一个量级。

第三是Tomcat的JVM内存配置。如果你的项目在本地跑得不卡、打包部署到服务器后频繁内存溢出，多半是JAVA_OPTS没调大。在catalina.sh里设置：

bash复制JAVA_OPTS="-server -Xms512m -Xmx1024m -XX:PermSize=128m -XX:MaxPermSize=256m"

JDK 8之后的版本PermSize变成了MetaspaceSize，参数也要相应调整。这里顺带说一句：如果你在开发阶段发现项目越来越大，Tomcat重启越来越慢，可以试着清理target目录后重新编译，很多“说不清哪里卡”的问题其实是陈旧编译产物在捣乱。

基于我个人把这个项目从零写到现在，最大的体会是：SSM+JSP这套技术栈虽然看起来“不过时但也不新潮”，它真正的价值在于把Java Web开发的底层链路完整地暴露在你面前。你亲手配置了DispatcherServlet，才知道Spring Boot的自动配置替你省了多少事；你亲手写了一堆Mapper XML，才理解MyBatis-Plus为什么这么受市场欢迎。做这类项目，不必因为技术老就看不上它，认真走一遍流程，面试时被问到“说说你对SSM整合的理解”“讲讲你做过的项目核心难点”，你是真的能说出东西来的。

最后再分享一个我在细节上的小坚持：项目里的每个Controller、Service方法的注释，我都会写上这个方法的业务背景和易错点，比如“这里必须先检查是否重复申请，避免同一用户重复提交”。代码是写给人看的，尤其是自己三个月后再回来看，会发现当时随手留下的注释比任何文档都管用。系统做完之后，我还往里面加了一个“救助站地图展示”的预留接口，被审核通过后的动物可以绑定救助站地址，虽然最终因为数据源问题没有上线，但在答辩时聊到这个扩展思路，评委的反馈明显比只看CRUD流程好得多。如果你也在做类似的系统，不妨也留一个这种“有思考的尾巴”，项目质量会完全不一样。

基于SSM+JSP的流浪猫狗信息管理系统设计与实现