企业官网建设流程全解析

一套JSP水产养殖系统，管的是鱼塘里那些事

前阵子接了一个课设项目的调试委托，标题叫“JSP智慧云农信息水产养殖0kczq”，程序、源码、数据库、调试部署、开发环境全套都带。说实话，看到“JSP”这三个字母的时候，我脑子里闪过的第一反应是：2025年了，还在用JSP？但等我真正把这套系统从头到尾跑通、读源码、拆数据库之后，我得承认一个事实——在高校课程设计和中小型管理系统的场景里，JSP+Servlet+MySQL这套组合依然活得很好，而且它作为教学项目，能让人把Web开发的底层逻辑看得明明白白。

这篇文章就把这套系统的技术拆解、环境搭建、数据库设计、代码链路和调试部署全过程写出来。不管你是正在做课设的学生，还是接手了类似外包项目需要快速跑通的老手，这篇文章应该能帮你省下不少试错的时间。

1. 从“智慧云农”看这个系统的业务边界

1.1 水产养殖系统到底在管什么

很多人一看到“智慧云农”这四个字，以为是什么高大上的物联网平台，实际上拆开看，这套系统的核心业务并不复杂。它本质上是一个面向水产养殖场景的信息管理系统，管理的对象是鱼塘、水质数据、投喂记录、渔获信息，以及操作这些数据的管理员账号。

搞水产养殖的人最关心什么？水温、溶氧量、pH值、氨氮含量。这些指标直接影响鱼虾的存活率和生长速度。传统养殖靠经验，智慧养殖靠数据。这套系统的“智慧”体现在，它把水质监测数据从人工记录变成了系统化的采集、存储和可视化查询，再结合投喂管理、渔获统计，形成一条完整的信息链。

所以拿到这套系统源码之后，不要急着看代码，先理清楚业务模块，你会发现它的功能划分其实是标准的增删改查四件套：用户登录后可以录入水质数据、维护鱼塘信息、记录投喂批次、查询历史记录并导出报表。

1.2 功能模块拆解：登录、水质、投喂、渔获

我通读源码之后，把系统功能梳理成了下面这张表，方便你对照代码去理解：

每个模块对应一套独立的JSP页面+Servlet类+DAO类。这种结构的好处是：职责清晰，一个模块出了问题，改动范围能控制在一个包内。坏处也很明显：代码量翻倍，复用性差。但这恰恰是课设项目的评分点——老师要看的就是你有没有分层意识。

1.3 为什么2025年还有人用JSP写系统

这是很多初学者的困惑。网上到处都在说Spring Boot、Vue前后端分离，怎么课设还在用JSP？这里我要说句公道话。

JSP的本质是在HTML里嵌入Java代码，由服务器动态渲染成页面返回给浏览器。它的优势是简单直观，一个请求从浏览器发出，经过Servlet接收、调用DAO层操作数据库、再转发到JSP渲染结果，整条链路没有中间层，特别适合理解Web开发的请求-响应模型。

而且对于课设场景，评分老师关注的是你有没有掌握Java Web的核心原理。JSP+Servlet+JDBC这套组合，恰恰能原汁原味地呈现底层逻辑。Spring Boot虽然强大，但它把太多细节封装掉了，你写完一个接口甚至不清楚HTTP请求是怎么被处理的。所以说，JSP不是过时，而是更适合教学和基础理解。

2. 搭开发环境别急着双击下一步：版本搭配才是关键

2.1 JDK、Tomcat、Maven的版本组合

这套系统我跑通时用的环境组合如下，你可以直接照着配，不用纠结版本新旧，重点是稳定兼容：

这里有个容易踩的坑：JDK版本和Tomcat版本不匹配。有人图新鲜装了JDK 17，然后发现Tomcat 8.5启动报错，查半天是版本兼容问题。JDK 8配Tomcat 8.5，这对组合我实测跑JSP项目零压力。

2.2 Maven换源与依赖下载失败

这套系统的依赖不算多，核心就是MySQL驱动、JSTL标签库，可能还有一个JSON处理库。但初学者第一次用Maven，十有八九会遇到依赖下载慢或者下载失败的问题，原因是默认访问Maven中央仓库，而国内网络访问这个仓库的延迟高得离谱。

解决办法是换阿里云镜像源。打开Maven安装目录下的conf/settings.xml，找到<mirrors>标签，加入以下配置：

<mirror> <id>aliyunmaven</id> <mirrorOf>central</mirrorOf> <name>阿里云公共仓库</name> <url>https://maven.aliyun.com/repository/public</url> </mirror>

改完之后，在IDEA的File -> Settings -> Build, Execution, Deployment -> Build Tools -> Maven里确认User settings file指向了这个settings.xml，然后重新导入项目让依赖刷新。这一步做完，下载速度从几十KB/s变成几MB/s，体感提升非常明显。

2.3 第一次启动Tomcat的报错排查

环境搭好之后，第一次在IDEA里配置Tomcat并启动，最常见的报错有三个：

• Artifact部署异常：报错信息类似Error during artifact deployment，多半是没选对war包或war exploded的部署方式。解决方法是：Run -> Edit Configurations -> Deployment，点加号选择Artifact，然后选项目名war exploded格式，Application context填写项目访问路径，比如/aquaculture。
• 端口占用：Tomcat默认8080端口被别的进程占了，报错Port 8080 is already in use。用netstat -ano | findstr 8080查进程PID，然后在任务管理器杀掉对应进程，或者干脆改Tomcat的端口配置。
• 404错误：启动成功但访问页面报404，通常是Application context配置不对。要确保你访问的URL和配置的context路径一致。比如context配置为/aquaculture，访问地址就是http://localhost:8080/aquaculture/。

这三个问题覆盖了九成以上的首次启动失败场景，记下来能省不少时间。

3. 数据库设计：把鱼塘、水质、投喂拆成一张张表

3.1 核心表结构：字段、类型、索引

数据库是这套系统的核心。我导出了完整的建表SQL，这里挑三张关键表做个拆解，让你理解它的设计思路。

第一张是管理员表admin_user，结构很简单：

CREATE TABLE `admin_user` ( `id` int(11) NOT NULL AUTO_INCREMENT, `username` varchar(50) NOT NULL COMMENT '登录用户名', `password` varchar(128) NOT NULL COMMENT '密码（MD5加密）', `real_name` varchar(50) DEFAULT NULL COMMENT '真实姓名', `create_time` datetime DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (`id`), UNIQUE KEY `uk_username` (`username`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

注意password字段长度设了128位，说明系统对密码做了MD5加密存储，而不是明文。这一点很关键，我在课设项目里见过太多明文存密码的，非常不安全。

第二张是水质记录表water_quality，这是业务核心：

CREATE TABLE `water_quality` ( `id` int(11) NOT NULL AUTO_INCREMENT, `pond_id` int(11) NOT NULL COMMENT '关联鱼塘编号', `water_temp` decimal(5,2) DEFAULT NULL COMMENT '水温（摄氏度）', `dissolved_oxygen` decimal(5,2) DEFAULT NULL COMMENT '溶氧量（mg/L）', `ph_value` decimal(4,2) DEFAULT NULL COMMENT 'pH值', `ammonia_nitrogen` decimal(6,3) DEFAULT NULL COMMENT '氨氮含量（mg/L）', `record_time` datetime DEFAULT NULL COMMENT '记录时间', `remark` varchar(255) DEFAULT NULL COMMENT '备注', PRIMARY KEY (`id`), KEY `idx_pond_id` (`pond_id`), KEY `idx_record_time` (`record_time`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

这张表的设计有几个值得学习的地方：水质指标的字段用了decimal类型，因为水温、pH这些数据有精度要求，用float会出现精度丢失的问题；pond_id加了普通索引，因为查询一定是以鱼塘为维度进行的；record_time也建了索引，因为统计查询最常见的筛选条件就是时间范围。

第三张是投喂记录表feed_record，字段包括投喂时间、饲料类型、投喂量、投喂人员等，设计思路和水质表类似，不再展开。

3.2 用dbx导入数据库并配置JDBC连接

拿到aquaculture.sql这个数据库脚本文件后，导入方式有两种。一种是命令行导入，另一种是用数据库可视化工具导入。

命令行方式最稳：

mysql -u root -p > create database if not exists aquaculture default character set utf8mb4; > use aquaculture; > source /path/to/aquaculture.sql;

如果你用的是dbx数据库工具，操作更直观：新建连接填上主机名（localhost）、端口（3306）、用户名（root）和密码，连接成功后右键选择运行SQL文件，找到aquaculture.sql执行即可。导入完成之后刷新表列表，能看到6-7张表就说明成功了。

数据库导入之后，还要修改项目的数据库连接配置。这套系统用的是传统的JDBC连接方式，配置信息一般在src/main/resources/db.properties或者一个叫DBUtil.java的工具类里。改三个地方：数据库URL、用户名、密码。

jdbc.driver=com.mysql.cj.jdbc.Driver jdbc.url=jdbc:mysql://localhost:3306/aquaculture?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai jdbc.username=root jdbc.password=123456

这里有个关键细节：characterEncoding=utf8必须要配，否则后面页面显示中文会乱码。serverTimezone=Asia/Shanghai是MySQL 8.0连接时必需的，不配会报时区错误。

3.3 中文乱码：一次配置治本

中文乱码是JSP项目里最高频的问题，没有之一。乱码的原因就一句话：请求、数据库、页面三端的字符编码不一致。解决方案是三层同时设置，缺一层都可能出问题。

第一层，数据库连接URL加字符编码参数，上文已经提到。第二层，在JSP页面顶部加编码声明：

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8" %>

第三层，如果涉及表单提交，在Servlet里加请求编码过滤：

request.setCharacterEncoding("UTF-8");

如果做三层检查之后还是乱码，大概率是Tomcat的server.xml里连接器配置少了URIEncoding：

<Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" URIEncoding="UTF-8" />

这套配置组合拳打下来，中文乱码基本绝迹。

4. 核心代码链路：从登录请求到水质数据的增删改查

4.1 登录与Session管理

登录功能是所有管理系统的门面，它也是理解JSP请求处理流程的最佳入口。这套系统的登录逻辑大致是这样的：

用户在前端页面login.jsp输入用户名和密码，提交到LoginServlet。LoginServlet在doPost方法里获取请求参数，调用AdminUserDao的findByUsernameAndPassword方法去数据库验证。验证通过后，把管理员对象存入Session：

User admin = userDao.findByUsernameAndPassword(username, password); if (admin != null) { // 登录成功，将用户信息存入session session.setAttribute("adminUser", admin); response.sendRedirect(request.getContextPath() + "/index.jsp"); } else { // 登录失败，带错误信息转发回登录页 request.setAttribute("errorMsg", "用户名或密码错误"); request.getRequestDispatcher("/login.jsp").forward(request, response); }

这里有两个细节值得注意。第一，登录失败用的是forward转发而不是sendRedirect重定向，这样可以在request域里携带错误信息，同时URL地址栏不会跳转，用户刷新时不会重复提交表单。第二，登录成功用重定向，这样用户按F5刷新不会再次提交登录请求，这是一个很实用的防重复提交技巧。

Session还有一层作用：拦截未登录用户访问内部页面。一般是通过一个LoginFilter过滤器实现，在web.xml里配置映射路径，对所有受保护资源进行拦截，如果Session里没有用户信息就跳回登录页。

4.2 DAO层的JDBC写法

这套系统没有用MyBatis或Hibernate，直接用JDBC操作数据库。DAO类的基本模式是统一的，我以水质记录查询为例展示核心代码：

public List<WaterQuality> findByPondId(int pondId) { List<WaterQuality> list = new ArrayList<>(); String sql = "SELECT * FROM water_quality WHERE pond_id = ? ORDER BY record_time DESC"; try (Connection conn = DBUtil.getConnection(); PreparedStatement ps = conn.prepareStatement(sql)) { ps.setInt(1, pondId); try (ResultSet rs = ps.executeQuery()) { while (rs.next()) { WaterQuality wq = new WaterQuality(); wq.setId(rs.getInt("id")); wq.setPondId(rs.getInt("pond_id")); wq.setWaterTemp(rs.getBigDecimal("water_temp")); wq.setDissolvedOxygen(rs.getBigDecimal("dissolved_oxygen")); wq.setPhValue(rs.getBigDecimal("ph_value")); wq.setAmmoniaNitrogen(rs.getBigDecimal("ammonia_nitrogen")); wq.setRecordTime(rs.getTimestamp("record_time")); list.add(wq); } } } catch (SQLException e) { e.printStackTrace(); } return list; }

这段代码有几个好习惯值得反复强调。第一，用PreparedStatement而不是Statement，既防止SQL注入又提升执行效率。第二，使用try-with-resources，连接、预处理语句、结果集都会自动关闭，避免连接泄漏。第三，查询结果在循环里逐行封装成实体对象，这样JSP页面拿到的是对象列表而不是原始结果集，解耦了数据库操作和页面展示。

增删改的操作模式也类似，区别是执行executeUpdate()方法，返回受影响的行数来判断操作是否成功。这种DAO统一模式在系统里被大量复制，看懂了其中一个方法，其他模块的代码也基本能看懂。

4.3 JSP页面渲染与分页查询

JSP页面负责把数据渲染成HTML。水质列表页面的大致结构如下：

<% List<WaterQuality> wqList = (List<WaterQuality>) request.getAttribute("wqList"); %> <table border="1" cellpadding="8" cellspacing="0" style="border-collapse:collapse;"> <tr> <th>编号</th> <th>鱼塘编号</th> <th>水温(℃)</th> <th>溶氧量(mg/L)</th> <th>pH值</th> <th>氨氮(mg/L)</th> <th>记录时间</th> <th>操作</th> </tr> <% if (wqList != null) { for (WaterQuality wq : wqList) { %> <tr> <td><%=wq.getId()%></td> <td><%=wq.getPondId()%></td> <td><%=wq.getWaterTemp()%></td> <td><%=wq.getDissolvedOxygen()%></td> <td><%=wq.getPhValue()%></td> <td><%=wq.getAmmoniaNitrogen()%></td> <td><%=wq.getRecordTime()%></td> <td><a href="editWaterQuality?id=<%=wq.getId()%>">编辑</a> <a href="deleteWaterQuality?id=<%=wq.getId()%>" onclick="return confirm('确定删除？')">删除</a></td> </tr> <% } } %> </table>

这就是JSP最原生的写法了：在HTML中嵌入Java代码做循环遍历。虽然不优雅，但逻辑非常直白。

再说分页。这套系统的分页查询很典型，它用的不是前端框架分页，而是后端SQL分页。核心思路是：接收当前页码参数pageNo，每页显示条数pageSize，然后在SQL里用LIMIT关键字做分页：

SELECT * FROM water_quality ORDER BY record_time DESC LIMIT ?, ?

同时再查总记录数，算出总页数。底部分页导航条就是一组上一页、下一页的链接，页码参数通过URL的query string传到JSP页面。这种分页实现思路简单、无刷新，后端渲染出来直接就是完整HTML，不需要任何JavaScript依赖，非常适合这个项目的技术栈。

有人会纠结为什么不用AJAX局部刷新，我的看法是：在课设项目里，正确、完整、能演示比花哨、现代、炫酷重要得多。把核心链路跑通，再谈优化。

5. 调试部署全流程：从本地跑通到上线部署

5.1 本地调试中常见的三类报错

调试阶段是花时间最多的环节，把高频报错整理出来，你要是遇到了可以直接对照查。

第一类：空指针异常（NullPointerException）。这种报错大多数是数据库查询返回了空结果，而代码没有做空判断。比如按ID查询鱼塘信息，传了一个不存在的ID，返回null，页面直接调用.getName()就崩了。解决方法是养成好习惯：所有从DAO层返回的对象，在使用前先判断是否为null；所有从请求参数里拿到的值，先判断是否为空字符串。

第二类：SQL语法错误。报错信息里通常包含check the manual that corresponds to your MySQL server version。这类错误大多是SQL语句里用了MySQL关键字做字段名，或者?占位符和setXxx方法的参数个数对不上。比如order、desc、group都是MySQL保留字，如果字段名叫这些，必须用反引号包起来。

第三类：ClassNotFoundException（找不到驱动类）。报错显示找不到com.mysql.cj.jdbc.Driver，原因是MySQL驱动JAR包没有打包到项目的WEB-INF/lib目录，或者Maven依赖没引入。检查pom.xml里是否有：

<dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>8.0.33</version> </dependency>

这三类报错占调试期问题总量的八成以上，逐一排查效率最高。

5.2 打war包与生产环境部署

本地跑通之后，下一步是部署。这套系统的最终产物是war包，war包本质就是一个压缩文件，里面是Web应用的完整目录结构。打包方式有两种。

方式一：在IDEA里操作。打开Project Structure -> Artifacts，点加号新建，选择Web Application: Archive，命名比如aquaculture.war，然后在Build -> Build Artifacts -> Build，war包就会生成在out/artifacts/目录下。

方式二：如果项目是Maven管理的，可以在pom.xml里配置<packaging>war</packaging>，然后在IDEA右侧Maven面板双击package，Maven会自动打包。

拿到war包后，部署就简单了：把war包复制到Tomcat安装目录的webapps文件夹下，启动Tomcat，它会自动解压并运行项目。访问地址就是http://服务器IP:8080/aquaculture/。

这里有个坑要提醒：war包名决定访问路径。如果你的war包叫ROOT.war，访问路径就直接是http://IP:8080/，不需要加项目名。如果想要自定义路径，war包改个名就行，比如改成aqua.war，访问地址就变成http://IP:8080/aqua/。

5.3 部署后功能验证清单

部署完成不等于工作完成，必须做一轮功能验证。我每次部署完都会按下面这份清单逐项测试，你也照着过一遍：

• 登录功能：输入正确账号密码能进入主页，输入错误密码能看到报错提示
• 页面样式：CSS是否正常加载，图片是否显示（JSP页面里的静态资源路径经常出问题）
• 增删改查：每个模块的新增、编辑、删除操作都能正确生效，刷新后数据不丢
• 数据展示：列表页能正确显示中文内容，没有乱码
• 分页导航：点击下一页能正常翻页，页码计算正确
• 数据库连接：Tomcat启动后没有任何连接数据库的异常堆栈

如果以上六项全部通过，这套系统的部署工作就算真正完成了。

6. 项目跑通之后，怎么扩展成真正能用的系统

6.1 从课设到生产的三个改进方向

说实话，这套系统的代码质量在课设级别里算中等偏上，但离生产可用还有一段距离。如果你想让这个项目不只是“能演示”，而是“真的能用”，可以从三个方向去改进。

第一个方向：引入连接池。目前系统是每次操作数据库都创建一个新连接，用完就关。在高并发场景下，连接创建和销毁的开销会拖垮数据库。可以接入Druid或HikariCP连接池，改造DAO层，让连接从连接池获取而非每次都新建。Druid还自带监控页面，可以直接在浏览器里看SQL执行情况，排错方便很多。

第二个方向：数据可视化。目前水质数据是以表格形式展示的，表格对趋势变化不敏感。可以引入ECharts，用折线图展示水温、溶氧量随时间的变化曲线。养殖户一眼就能看出水质变化趋势，比看数字表格直观得多。技术实现也不难，从一个查询接口返回JSON数据，前端用AJAX拉取然后渲染图表即可。

第三个方向：权限分级。目前系统只有管理员一个角色。真正的水产养殖场景里，可能有场长、技术员、操作工等多个角色，不同角色能看的数据和能执行的操作应该是不同的。可以引入角色-权限模型，在现有用户表上增加角色字段，在页面操作按钮上加权限判断。

6.2 环境配置与源码学习的一些个人经验

最后说几句实在话。我在调试部署这套系统的过程中，最大的感受是：JSP项目最大的门槛从来不是Java代码，而是环境问题和依赖问题。一个项目从拿到手到跑通，花在装环境、配依赖、改编码上的时间往往比读代码的时间还多。所以我的建议是，拿到任何一套源码，先不要急着读代码逻辑，先按顺序做三件事：配环境、导数据库、启动项目，让系统先跑起来。系统跑起来之后，代码逻辑顺着请求链路看，反而容易理解。

另外，源码学习有一个高效路径：先跑通项目，再看核心功能模块的代码，然后尝试做一些小改动，比如加一个字段、增加一个筛选条件，改完发现页面有变化了，就说明你对这套系统的理解已经到位了。这种“动手验证”的学习方式，比从头到尾一行行读代码效率高十倍。

这套系统后续的扩展方向其实不少，如果要做成真正的智慧农业系统，可以接入物联网设备自动采集水质数据，替代人工录入；可以加预警机制，溶氧量低于阈值时自动短信报警；可以做数据大屏，在一块显示器上展示所有鱼塘的实时状态。但这些都是后话，先把手里这套跑通、看懂、落地，才是一切的基础。