企业官网建设流程全解析

接手这个项目之后，我把它完整跑通并翻了一遍代码。这篇博文就还原整个过程：从压缩包里的文件结构，到环境搭建、数据库导入、Tomcat部署，再到业务代码的调用链路，最后聊几个可以继续扩展的方向。正在做JSP课程设计、准备毕业设计，或者刚学完Servlet/JSP想看看真实项目长什么样的人，这篇应该能省你不少时间。

1. 压缩包里的“家底”：一个JSP课设项目的完整盘算

拿到任何项目，第一步都是拆包，别急着找运行文档。压缩包命名里写了“程序+源码+数据库+调试部署+开发环境”，实际解压之后，里面的东西确实比很多只有源码的压缩包要全得多。简单盘一下，核心是这几类内容。

1.1 源码目录：不是标准Maven结构也没关系

项目源码是典型的Java Web工程目录。如果不是用IDEA的Maven骨架建的，而是直接创建的传统Web项目，目录会长这样：

qilu/ ├── src/ │ ├── main/ │ │ ├── java/ │ │ │ └── com/qilu/ │ │ │ ├── controller/（或servlet/） │ │ │ ├── service/ │ │ │ ├── dao/ │ │ │ └── entity/ │ │ └── webapp/ │ │ ├── WEB-INF/ │ │ │ ├── web.xml │ │ │ └── lib/（jar包） │ │ ├── index.jsp │ │ ├── list.jsp │ │ ├── detail.jsp │ │ └── admin/（后台页面） ├── database/ │ └── qilu.sql（建库脚本+初始数据） ├── README.txt └── qilu.war（可选的打包产物）

如果它带pom.xml，那就是Maven结构；如果只有web目录和一堆jar包，就是传统结构。这两种我都会在下面讲到，实际处理起来差别不大，关键是知道你的项目属于哪一种。

1.2 技术栈一眼看穿：JSP + Servlet + JDBC

这个项目没有用Spring、Spring Boot这类框架，核心依赖就是Servlet、JSP、JSTL和MySQL驱动，可能再加一个连接池。技术选型很“课程设计标准答案”，但对学习来说反而是好事，因为每一层代码都是公开透明的，你能看清一次完整请求从头到尾走过的每一步。

技术栈清单如下：

1.3 功能模块：齐鲁文化名人网站到底有哪些功能

这类文化名人展示网站，功能不会特别复杂，但麻雀虽小五脏俱全。齐鲁历史文化名人这个主题，选材上通常覆盖山东历史上的代表人物，比如春秋战国的孔子、孟子、墨子、管仲、晏婴，三国的诸葛亮，两晋的王羲之，唐宋的颜真卿、李清照、辛弃疾，清代的蒲松龄等等。

模块上，我盘下来基本上是这么几块：

• 前台展示：首页轮播+名人列表，列表页是按朝代/类型筛选
• 详情页：名人的生平简介、主要成就、代表作品、相关名言
• 后台管理：管理员登录，名人的增删改查
• 辅助功能：分类管理、留言板（有的版本有）

每一块页面之间通过Servlet跳转串联，数据全部从MySQL读出来，没有写死的静态内容。这一点是这类项目的核心学习价值所在。

2. 开发环境组装：版本不匹配，后面全是坑

环境这块是整个项目能否跑起来的关键。我这里直接给一组稳定可靠的版本搭配组合，然后逐个说明为什么要这样选。

2.1 版本搭配对照表

为什么强调JDK 8 + Tomcat 8.5/9？因为很多老项目用的还是javax.servlet包，Tomcat从10.0开始把包名整体改成了jakarta.servlet。如果你拿Tomcat 10去跑老项目，JSP页面一打开就会报java.lang.NoClassDefFoundError: javax/servlet/...，第一反应可能以为代码有问题，其实是环境版本不对。我见过太多人在这一步浪费一下午。

还有一点要提醒：MySQL 8.0的JDBC驱动类名是com.mysql.cj.jdbc.Driver，而MySQL 5.x用的是com.mysql.jdbc.Driver，写数据库配置文件的时候别搞混。另外MySQL 8.0的JDBC URL建议把时区和SSL参数带上，不然连接时会报The server time zone value之类的错误，后面数据库配置那节我会详细说。

2.2 用IDEA打开项目的正确姿势

如果你是第一次接手这种源码项目，我建议的操作顺序是这样的。

先确认自己的IDEA是Ultimate版。社区版虽然能打开Java项目，但对Java Web开发支持不全，Tomcat集成、Web插件都是Ultimate才有的。接着把项目解压到不含中文和空格的路径，比如D:\projects\qilu，千万别放在桌面带中文的文件夹里，Tomcat和IDEA对中文路径的容忍度极低。

如果你拿到的是Maven工程（有pom.xml），用IDEA的Open选项直接选择pom.xml打开，IDEA会自动识别依赖并拉取jar包。打开后进入Project Structure确认Project SDK设置为JDK 8，Language level也跟着设到8。如果是传统工程（没有pom.xml但WEB-INF下有lib目录），就Open整个目录，然后右键项目选择Add Framework Support，勾选Web Application，把web根目录指到src/main/webapp。

这里有个细节很容易踩坑：传统工程导入后，IDEA有时候不知道web.xml在哪里，导致后面配置Artifacts时生不成正确的War包，报错信息会是“Artifact without web.xml”。解决办法是到Project Structure -> Facets里，把Web模块的Web Resource Directory手动指到src/main/webapp目录，对应的Web.xml路径指到WEB-INF/web.xml。

2.3 Maven依赖还是本地jar包

这个项目是传统结构和Maven结构都可能有。如果是传统结构，jar包一般在WEB-INF/lib下，比如：

lib/ ├── mysql-connector-java-8.0.27.jar ├── jstl-1.2.jar ├── commons-dbutils-1.7.jar └── druid-1.2.8.jar

如果是Maven结构，pom.xml里的依赖大概是这样的：

<dependencies> <dependency> <groupId>javax.servlet</groupId> <artifactId>javax.servlet-api</artifactId> <version>4.0.1</version> <scope>provided</scope> </dependency> <dependency> <groupId>javax.servlet</groupId> <artifactId>jstl</artifactId> <version>1.2</version> </dependency> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>8.0.27</version> </dependency> <dependency> <groupId>com.alibaba</groupId> <artifactId>druid</artifactId> <version>1.2.8</version> </dependency> </dependencies>

这里唯一的坑是javax.servlet-api的scope是provided，意思是编译时用它，但部署到Tomcat时由Tomcat自己提供。如果漏写了provided，打出来的War包会自带Servlet API，和Tomcat内置的冲突，启动时可能出现奇怪的错误。

3. 数据库那点事：建库、导入、连接池配置与中文乱码根因

这个项目的数据库是个ac重要部分。压缩包里通常带一个.sql脚本，但很多人拿到脚本不知道怎么用，或者导入时报错，或者启动后页面显示乱码。我一个个讲清楚。

3.1 数据库表设计的长相

先看设计。文化名人网站，核心表一般就三张起步，加上管理员和留言，大概是五张表左右。根据我对这类项目的经验，表结构大致是下面这样：

名人大表（famous_person）

管理员表（admin_user）

再加上朝代分类表、留言表之类的，视版本而定。核心还是名人大表和分类表之间的关联。如果你是自己在做类似项目，表结构可以直接参考这个设计，完全够用。

3.2 导入SQL脚本的两种方式

拿到.sql文件后，在Navicat或MySQL Workbench里右键数据库选择“运行SQL文件”，指向qilu.sql即可。这里有个注意点：脚本里如果包含创建数据库的语句，先看它是CREATE DATABASE还是只建表。如果是只建表，你需要先在命令行或者IDE里手动创建库：

CREATE DATABASE qilu DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

然后执行：

mysql -u root -p qilu < qilu.sql

另一个高频坑是：脚本文件本身的编码。如果.sql文件是UTF-8编码，而你的MySQL客户端默认是GBK，导入后中文全部变成问号。解决办法是导入前在文件头加入SET NAMES utf8mb4;，或者在Navicat连接属性里把编码设为UTF-8。这种问题不会直接报错，但后面页面上全是“???”，排查起来很费劲。

3.3 连接池配置与数据库参数的写法

项目里的数据库配置文件通常是db.properties或者jdbc.properties，放在src根目录下。如果你拿到的是传统项目，可能直接写在JDBCUtil工具类里。我建议改成独立的properties文件，后续维护方便。标准写法如下：

jdbc.driver=com.mysql.cj.jdbc.Driver jdbc.url=jdbc:mysql://localhost:3306/qilu?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai jdbc.username=root jdbc.password=你的密码 jdbc.initialSize=5 jdbc.maxActive=20

这里有三处需要注意。一是useUnicode=true&characterEncoding=utf8，简写characterEncoding=utf8即可，它和页面的编码配合，解决中文乱码。二是serverTimezone=Asia/Shanghai，MySQL 8.0必须加，否则连接时会因为时区不明确报错。三是MySQL 5.x驱动类名要改回com.mysql.jdbc.Driver，其他不变。

如果你用的是内置DBCP连接池，配置会是这样：

BasicDataSource ds = new BasicDataSource(); ds.setDriverClassName("com.mysql.cj.jdbc.Driver"); ds.setUrl("jdbc:mysql://localhost:3306/qilu?characterEncoding=utf8"); ds.setUsername("root"); ds.setPassword("123456");

其实原理都一样：加载驱动、建立连接、复用连接。连接池就是为了避免每次查询都去创建物理连接，因为创建连接本身就是最耗时的操作之一。一个访问量不高的课设网站，连接池参数用默认值就够，但你要明白它存在的意义。

3.4 中文乱码的根因与三层排查法

乱码问题在JSP老项目里几乎是必现的，而且一个地方漏配就会全盘乱掉。乱码本质上是字符编码不一致造成的，一共三条链路，哪一条断了都会乱。

第一层是数据库连接层，也就是connection的URL要带characterEncoding=utf8，让JDBC驱动以UTF-8编码把数据写入MySQL。第二层是页面显示层，JSP文件头部要有<%@ page contentType="text/html;charset=UTF-8" %>，同时保存文件时IsEclipse/IDEA的文件编码也要是UTF-8，否则页面本身内容写出来就是乱掉的。第三层是请求接收层，Servlet里要设置request.setCharacterEncoding("UTF-8")，否则表单提交的中文姓名会变成问号。

凡是遇到中文文字“???”或者显示成菱形乱码的，从这三层逐层检查。实在不行就在web.xml里加一个编码过滤器，用Spring那个CharacterEncodingFilter会省心很多：

<filter> <filter-name>encodingFilter</filter-name> <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class> <init-param> <param-name>encoding</param-name> <param-value>UTF-8</param-value> </init-param> <init-param> <param-name>forceEncoding</param-name> <param-value>true</param-value> </init-param> </filter> <filter-mapping> <filter-name>encodingFilter</filter-name> <url-pattern>/*</url-pattern> </filter-mapping>

如果项目没引入Spring，那就自己写一个Filter，类名随意，doFilter里先设编码再放行，逻辑很简单，二十行代码搞定。

4. 把网站跑起来：从IDEA到浏览器的一整条链路

环境准备完毕、数据库数据导入完成之后，进入最激动人心的环节：把Tomcat跑起来，在浏览器里看到齐鲁历史文化名人的首页。这一步的完整演示和经典报错排查，我放在这一节一起说。

4.1 配置Tomcat并部署项目的三种路径

IDEA里配置Tomcat，先选Run -> Edit Configurations，然后点左上角加号，找到Tomcat Server -> Local。首次配置会让你选Tomcat Home，指到Tomcat安装目录，比如D:\apache-tomcat-9.0.85。

然后是部署那一栏。Deployment标签页里，点加号选择Artifact。Maven项目会出现qilu:war和qilu:war exploded两个选项。war exploded的意思是“展开的war包”，相当于把web目录直接映射到Tomcat，修改页面后刷新就能生效，开发阶段用这个最方便。

部署完再看Application context，它是访问路径的根。默认可能是/qilu_war_exploded，太长，我习惯改成/qilu。这样启动后访问地址就是http://localhost:8080/qilu。注意，context如果配置不对，页面会404，但代码和数据库都没问题，这是新手最容易困惑的地方之一。

第二种方式是把项目打成war包直接丢到Tomcat的webapps目录。这适合最终交付或者在别的机器上演示的时候。IDEA里Build -> Build Artifacts，选择qilu:war的Build动作，完成会在target目录生成qilu.war。把这个文件复制到Tomcat的webapps下，启动Tomcat，它会自动解压部署。访问路径同样取决于war包文件名。

第三种是传统工程的方式：项目右键，选择Deployment -> Run on Server，只要IDE正确识别了Web框架，就能直接启动。这三种方式本质一样，都是把项目通过Tomcat暴露成HTTP服务，区别只是打包和部署的形式。

4.2 启动全过程的完整验证清单

配好后点启动按钮，控制台会滚出一串日志，直到看到类似下面这几行，才说明启动成功：

信息: Starting ProtocolHandler ["http-nio-8080"] 信息: Server startup in [1,250] milliseconds

启动之后别急着点页面，先做三件事验证：

1. 访问http://localhost:8080/qilu，确认首页能出内容
2. 访问http://localhost:8080/qilu/list.do?era=春秋战国，确认列表页动态数据能查到
3. 随便点击一个名人详情，确认详情页和图片能正常加载

如果首页出来了但列表页数据为空，先别改代码，回到数据库执行一遍SELECT * FROM famous_person，看看表里有没有数据。很多情况下，SQL脚本是建表和插入数据合在一起的，导入时如果半路报错，会导致数据没插完全，页面自然就是空的。

4.3 高频报错排查表：完整链路中的那些坑

我整理了一份基于这类JSP项目的高频报错清单，每条都是我见过很多次的，可以直接对照自查。

这里面最隐蔽的是JSTL的问题。很多老项目的列表页长这样：

<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>

如果lib目录里没有jstl.jar和standard.jar，页面会直接500，而且Tomcat日志里报的错误可能模模糊糊，比如提示“Unable to find tag library”。解决办法就是补依赖。Maven里加上jstl 1.2，传统工程就把两个jar放去WEB-INF/lib目录。

4.4 调试技巧：日志、打印和断点三件套

如果页面有数据但显示不对，不要干瞪眼看页面，按这三步来排查。第一，看Tomcat的Console日志和logs目录下的localhost.log / catalina.out，异常堆栈基本都会打在这里。第二，在Servlet和DAO的关键位置加System.out.println()，把接收到的参数、拼出来的SQL、查询到的结果集数量全打印出来。老项目没有Logback也没有lombok，这是最快的方式。第三，如果IDE环境允许，直接在DAO方法里打断点，F7单步跟入，看ResultSet里到底有没有值，以及每个字段的取值。

这三个方法从粗到细，能覆盖九成以上的问题。别一上来就怀疑代码写错了，先用日志确认数据流走到了哪一层。

5. 齐鲁名人业务代码的心法：从JSP页面到数据库的完整链路

项目跑起来只是第一步，真正值钱的是看懂代码里的一次完整请求。以“点击某个名人查看详情”为例，我把这条链路拆开讲透。

5.1 一次请求是如何流转的

页面地址栏输入http://localhost:8080/qilu/detail.do?id=3，Tomcat收到请求后，先根据.do后缀和web.xml的配置找到对应的Servlet。要么是web.xml里写了：

<servlet-mapping> <servlet-name>PersonServlet</servlet-name> <url-pattern>*.do</url-pattern> </servlet-mapping>

要么是Servlet类直接用了注解：

@WebServlet("/detail.do") public class PersonDetailServlet extends HttpServlet { @Override protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException { // 1. 接收参数 String id = req.getParameter("id"); // 2. 调用Service/DAO拼接JDBC查询 PersonDao dao = new PersonDao(); FamousPerson person = dao.findById(Integer.parseInt(id)); // 3. 把数据塞进request域，转发给JSP req.setAttribute("person", person); req.getRequestDispatcher("/detail.jsp").forward(req, resp); } }

这里面体现的是标准MVC思想：Servlet当控制器，负责接参、调服务、分发页面；DAO负责数据访问；JSP只负责显示数据，不写业务逻辑。注意第3步用的是forward而不是redirect，因为forward是服务端内部转发，这种方式能把request里存放的数据原封不动交给detail.jsp去渲染。如果用redirect，相当于让浏览器重新发起一次新请求，之前塞进request里的属性全部丢失，detail.jsp页面拿到的就是null。

5.2 DAO层与PreparedStatement的正确写法

DAO层的核心方法长这样：

public FamousPerson findById(int id) { String sql = "SELECT * FROM famous_person WHERE id = ?"; try (Connection conn = DBUtil.getConnection(); PreparedStatement ps = conn.prepareStatement(sql)) { ps.setInt(1, id); try (ResultSet rs = ps.executeQuery()) { if (rs.next()) { FamousPerson p = new FamousPerson(); p.setId(rs.getInt("id")); p.setName(rs.getString("name")); p.setEra(rs.getString("era")); p.setAchievement(rs.getString("achievement")); return p; } } } catch (SQLException e) { e.printStackTrace(); } return null; }

这里有几个很好的习惯是这个项目代码里值得学习的。一是用PreparedStatement而不是简单字符串拼接，因为在SQL里拼参数会有SQL注入风险，课程设计项目虽然不要求高安全性，但规范就是规范，这个判断和习惯能延伸到以后工作项目。二是用try-with-resources自动关闭Connection、PreparedStatement、ResultSet，这样不用手动在finally里写一堆close，也避免连接泄露。三是ResultSet取字段用列名而不是下标，后续如果加字段，代码改动量最小。

你可能会问Service层是干嘛的。如果项目分了三层，Service代码会写业务逻辑，比如“点击量+1”“判断是否重复上榜”这种，DAO就只管纯粹的数据增删改查。如果项目只有Servlet+DAO两层，那也可以接受，毕竟课设规模在那里，控制层直接调用DAO不会造成太大问题。

5.3 JSP显示层：EL和JSTL的配合

detail.jsp面的显示，几乎可以无脑用EL表达式加JSTL。整个页面的核心就几行：

<%@ page contentType="text/html;charset=UTF-8" language="java" %> <%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %> <html> <body> <h1>${person.name}</h1> <p>朝代：${person.era}</p> <p>类型：${person.fieldType}</p> <p>生平：${person.biography}</p> <p>成就：${person.achievement}</p> <p>名言：${person.famousWords}</p> </body> </html>

EL表达式${person.name}，实际上就是调用person.getName()方法。用这种方式的一大好处是相较于<%=request.getAttribute("person").getName()%>要简洁得多，而且如果person为null，EL会显示空字符串而不是抛NullPointerException，页面友好很多。

列表页用<c:forEach>遍历：

<c:forEach items="${personList}" var="p"> <div class="card"> <h3>${p.name}</h3> <p>${p.era} · ${p.fieldType}</p> <a href="detail.do?id=${p.id}">查看详情</a> </div> </c:forEach>

这套写法放到任何老JSP项目里都通用，理解一次，以后接手类似项目都能快速上手。

5.4 后台管理：登录、新增、编辑、删除这一整套

后台管理部分也不是很复杂的东西。登录的思路就是表单提交账号密码，Servlet查admin_user表，查到了就session.setAttribute("adminUser", user)，然后转发到后台首页；查不到就返回登录页并提示“用户名或密码错误”。有的版本会做MD5加密再比对，有的直接明文比，看原始项目程度，有加密总比没有好。

新增和编辑是用同一个JSP页面，区别在于有没有默认值。进入编辑页时，Servlet根据id查出该名人的信息存到request域，JSP里用value="${person.name}"回填，这样新增和编辑能复用一套UI。删除就更直接，DELETE FROM famous_person WHERE id=?，执行完重定向回列表页。

整个后台做下来你会发现，所有操作的套路都一致：接参数、拼SQL、执行、跳转。把一次完整的增删改查走通之后，做任何类似的管理系统都没有障碍了。齐鲁历史文化名人网站这个项目最大的价值就在这里，它不是花哨的框架组合，而是能把基础链路练扎实。

6. 拿到源码之后的二次开发：搜索、分页、前端升级

项目跑通、代码看懂之后，如果还要交作业或者想拿这个项目做扩展，以下这几个方向是最常见也最实用的。

6.1 给列表页加一个搜索框

需求很简单：在列表页搜孔子、搜“家”之类的关键词，或者按朝代筛选。后台实现的思路是在原有list Servlet里增加一个keyword参数：

public List<FamousPerson> search(String keyword) { String sql = "SELECT * FROM famous_person WHERE name LIKE ? OR biography LIKE ?"; String like = "%" + keyword + "%"; try (Connection conn = DBUtil.getConnection(); PreparedStatement ps = conn.prepareStatement(sql)) { ps.setString(1, like); ps.setString(2, like); try (ResultSet rs = ps.executeQuery()) { // 遍历封装 } } return list; }

页面端在列表顶部加一个输入框和按钮，提交到同一个list.do，后端根据是否有keyword参数决定调用哪种查询。注意LIKE语句中的百分号要拼在参数里，而不是拼在SQL语句里，不然PreparedStatement预编译的意义就没了。

6.2 分页查询的实现

名人数量多了，一页显示所有会显得又长又慢。分页的逻辑不算难，关键是用好LIMIT：

int pageNum = Integer.parseInt(request.getParameter("pageNum")); // 当前页，默认1 int pageSize = 8; // 每页8条 int offset = (pageNum - 1) * pageSize; String sql = "SELECT * FROM famous_person ORDER BY sort_order LIMIT ? OFFSET ?";

总条数用SELECT COUNT(*) FROM famous_person取到，页数用(total + pageSize - 1) / pageSize算出来。然后页面上加“上一页”“下一页”和“第X页/共Y页”的链接，点下一页时把pageNum传过来。整套逻辑大概20行代码，但实战中非常常用，值得动一次手。

6.3 换一套现代前端样式

老项目的CSS样式可能是纯手写内联样式，页面观感大概停留在“能看”的级别。要把颜值提上去，最快的办法是引入Bootstrap或Layui的CDN。比如列表页的卡片布局：

<link rel="stylesheet" href="https://cdn.bootcdn.net/ajax/libs/twitter-bootstrap/5.2.3/css/bootstrap.min.css">

然后把原来的table布局改成卡片、栅格布局，详情页改成两栏图文布局，后台上传的图片也能以更规整的方式显示。换样式不会影响任何Java后端的逻辑，因为JSP页面最终生成的还是HTML，Servlet和数据层完全不关心页面长什么样这一层面的细节。这也正是JSP项目适合做二次开发的原因，改哪一层都很独立。

6.4 向框架项目迁移的思路

如果未来有下一步学习计划，可以考虑把这个项目用Spring Boot重写一遍。迁移思路不复杂：名人大表的实体类直接复制，DAO改成MyBatis的Mapper接口，Servlet改成Controller，JSP可以继续沿用（Spring Boot支持JSP但需要额外配置，或者直接用Thymeleaf替代）。

迁移一遍的过程，会逼你重新理解框架是如何封装Servlet那些重复劳动的。到那时候再回头看这个JSP项目，你会发现自己对请求转发、请求域、转发和重定向这些概念的理解扎实很多，这是直接上手Spring Boot的初学者不具备的底层感知。

我在实际跑这个项目的时候，最有感触的一点是：越是不起眼的老技术栈，越能把内容沉淀出来。这个齐鲁历史文化名人网站，技术面覆盖了环境、数据库、部署、前后端交互，单看任何一个点都不难，但串在一起就是一个完整的Web项目闭环。拿到项目的朋友，别急着找人帮忙跑通，先静下心按照环境对齐、数据库导入、部署启动、代码分析这个顺序走一遍，每解决一个问题，你对Java Web的整体理解就会牢实一分。