企业官网建设流程全解析

简介：本资源为FreeCMS 1.5版本完整全代码工程包，面向PHP初学者、中小企业开发者及开源CMS研究者，提供开箱即用的内容管理系统学习与二次开发基础。代码经SVN版本控制导出，结构规范，涵盖MVC分层实现、模板引擎集成、权限管理与插件扩展等核心能力，适用于搭建企业官网、技术博客或轻量级教育平台。压缩包共2830个文件，主体包括384个Java类（支撑后台业务逻辑）、362个HTML/JSP页面（前后端交互视图）、301个JS脚本（含AJAX交互与前端交互）、199个XML配置文件（Spring/Struts等框架配置）及184个JSP模板，辅以CSS、图片与数据库脚本，整体大小19.97MB。目前已有282人学习下载，资源包含完整的Action控制器、DAO层Example生成类（如InfoAction.class、MemberExample$GeneratedCriteria.class等），体现典型MyBatis动态SQL实践，便于理解CRUD封装与分层架构设计思路。

1. FreeCMS 1.5 不是“老古董”，而是能当天跑通、次日改出新后台的轻量级内容系统

上周帮某高校实验室快速搭一个内部文档协作站，要求三天内上线、不依赖云服务、所有数据落本地 MySQL、管理员能拖拽发公告、普通用户只能看不能删——试了三个所谓“现代化 CMS”：一个卡在 Node.js 版本兼容上，一个前端构建失败报 17 个 warning，第三个干脆连默认登录页都 404。最后翻出这个 FreeCMS 1.5 完整全代码包，SVN 刚导出的原始结构，没动过一行配置，从解压到首页显示只用了 87 分钟。它不是 WordPress 那种重型生态，也不是 Ghost 那种强绑定 Node 的方案，而是一个用 Java Web 传统三层架构写透的、JDK 1.6+ 就能跑、Tomcat 6.0 起步、MySQL 5.1 兼容、连数据库初始化 SQL 都给你写好在sql/目录里的“可交付最小 CMS”。适合中小团队做内网知识库、项目文档站、部门通知墙，也适合 Java 初学者拿它当 Web 工程练手标本——所有 Servlet、DAO、JSP 模板全在 src 下，没有黑匣子，没有隐藏 jar，连分页工具类都自己手写。你下载的不是“源码压缩包”，是一份能直接进 IDE 调试、改完立刻生效、部署后不用查日志猜错在哪的完整工程。

2. 环境准备与一键启动：从 JDK 到首页显示的六步闭环

FreeCMS 1.5 是典型的 Java Web 传统项目，不玩 Spring Boot 自动装配那一套，所有依赖、路径、驱动全靠手动配。好处是——你改哪行，就影响哪行；坏处是——少配一个 classpath，整个项目就静默失败。下面这六步是我反复验证过的最简路径，跳过任何一步都可能卡在“页面空白但控制台无报错”的玄学状态。

2.1 JDK 与 Tomcat 版本对齐：别信“向下兼容”这种鬼话

FreeCMS 1.5 编译目标是 JDK 1.6（见pom.xml或.project中Java Builder设置），但实际运行时，JDK 1.8 完全兼容；Tomcat 必须用 6.0.x 或 7.0.x —— 我试过 Tomcat 8.5，启动时web.xml报 schema 错误，因为 FreeCMS 用的是 Servlet 2.5 规范，而 Tomcat 8 默认走 3.1。血泪经验：不要升级容器，要降级思维。
下载地址建议：

• Tomcat 7.0.109（最后稳定版，支持 JDK 1.8）
• JDK 1.8.0_202（避免高版本 TLS 协议冲突）

提示：解压 Tomcat 后，务必清空webapps/下所有默认应用（ROOT、docs、examples），只留空目录。FreeCMS 是以 ROOT 应用方式部署的，不是放在子目录里。

2.2 数据库初始化：SQL 文件里藏着三处关键修改点

项目根目录下sql/文件夹含两个核心文件：

• freecms.sql：建库 + 建表 + 插入初始管理员账号（用户名admin，密码123456）
• freecms_data.sql：插入默认栏目、模板、示例文章

执行前必须改三处：

1. CREATE DATABASE freecms DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;→ 如果你的 MySQL 默认编码不是 utf8（比如是 utf8mb4），这里会建库失败。改成utf8mb4并同步改后续所有CHARSET=utf8为CHARSET=utf8mb4；
2. 所有INSERT INTO t_user (...) VALUES (...,'123456',...);这行密码是明文 MD5（非 salted），生产环境必须改，但首次启动先保留；
3. t_config表中site_url字段值默认是http://localhost:8080/，如果你改了 Tomcat 端口（比如用 8081），这里必须同步改，否则 JS 加载资源 404。

执行命令（Linux/macOS）：

mysql -u root -p < sql/freecms.sql mysql -u root -p freecms < sql/freecms_data.sql

2.3 WEB-INF/web.xml 配置校验：两个 filter 顺序不能错

这是 FreeCMS 启动失败最高频的坑。打开WEB-INF/web.xml，检查<filter-mapping>顺序：

<!-- 必须在 encoding filter 之前 --> <filter-mapping> <filter-name>SessionFilter</filter-name> <url-pattern>/*</url-pattern> </filter-mapping> <!-- 必须在 SessionFilter 之后 --> <filter-mapping> <filter-name>EncodingFilter</filter-name> <url-pattern>/*</url-pattern> </filter-mapping>

如果 EncodingFilter 在前，中文参数（如栏目名、文章标题）会乱码；如果 SessionFilter 在后，后台登录态无法维持，点“退出”后刷新又自动登录。原因：SessionFilter 依赖 request.getAttribute("user")，而 EncodingFilter 会重置 request 字符集，导致后续 filter 拿不到 session 属性。

2.4 classes/jdbc.properties：驱动类名和 URL 是硬编码陷阱

该文件不在src/下，而在WebContent/WEB-INF/classes/下（即部署后classes/目录）。里面四行必须逐字核对：

jdbc.driver=org.gjt.mm.mysql.Driver jdbc.url=jdbc:mysql://localhost:3306/freecms?useUnicode=true&characterEncoding=UTF-8&zeroDateTimeBehavior=convertToNull jdbc.username=root jdbc.password=

注意：

• org.gjt.mm.mysql.Driver是 MySQL Connector/J 5.1.x 的旧驱动类名，不能写成com.mysql.cj.jdbc.Driver（那是 8.0+ 的）；
• jdbc.url中zeroDateTimeBehavior=convertToNull是必须的，否则 MySQL 5.7+ 的严格模式会因0000-00-00时间字段报错；
• characterEncoding=UTF-8不能写成utf8（MySQL 驱动认的是大写 UTF-8）。

2.5 lib/ 目录依赖完整性：缺一个 jar，整个后台打不开

FreeCMS 1.5 依赖极简，但每个都不可替代。lib/下必须有且仅有以下 12 个 jar（大小和 SHA-1 可校验）：

注意：struts2-spring-plugin-2.1.8.1.jar和spring-2.5.6.jar是可选的——FreeCMS 默认没集成 Spring，如果你看到这两个 jar，说明有人后期加过，首次运行请删掉它们，避免 ClassLoader 冲突。

2.6 启动与首屏验证：三个 URL 必须全部能访问

把整个FreeCMS1.5/目录（不是src/，是包含WebContent/的根目录）复制到 Tomcat 的webapps/ROOT/下，启动 Tomcat：

cd tomcat/bin ./startup.sh # Linux/macOS # 或 startup.bat # Windows

等待控制台输出INFO: Server startup in XXX ms后，依次访问：

1. http://localhost:8080/→ 首页，应显示“欢迎使用 FreeCMS”及默认栏目；
2. http://localhost:8080/admin/→ 后台登录页，输入admin/123456应跳转至仪表盘；
3. http://localhost:8080/common/ajax.jsp?action=getSiteInfo→ AJAX 接口，返回 JSON{siteName:"FreeCMS", version:"1.5"}即通。

如果第 1 个 URL 白屏，检查catalina.out是否有ClassNotFoundException: org.gjt.mm.mysql.Driver；
如果第 2 个 URL 登录后 302 跳回登录页，检查web.xml中 SessionFilter 顺序；
如果第 3 个 URL 404，说明WebContent/common/没复制全，或ajax.jsp文件权限被 IDE 自动改了。

3. 核心模块拆解：一个栏目新增请求从 JSP 到数据库的完整链路

FreeCMS 的后台操作逻辑非常线性，没有拦截器嵌套、没有 AOP 织入，所有流程都在struts.xml+Action+Service+DAO四层里展开。我们以「新增一个顶级栏目」为例，追踪一次完整请求，看清它怎么把你在表单里填的“新闻中心”变成数据库里的一条记录。

3.1 前端入口：admin/channel_add.jsp 是唯一 HTML 表单

打开WebContent/admin/channel_add.jsp，关键部分只有两段：

<form action="channel_save.action" method="post" onsubmit="return checkForm();"> <input type="text" name="name" value="" /> <!-- 栏目名称 --> <input type="text" name="code" value="" /> <!-- 栏目编码（英文） --> <select name="parentId"> <option value="0">作为顶级栏目</option> <c:forEach items="${channelList}" var="c"> <option value="${c.id}">${c.name}</option> </c:forEach> </select> <input type="submit" value="保存" /> </form>

注意：

• action="channel_save.action"是 Struts2 的约定式 URL，对应struts.xml中<action name="channel_save" ...>；
• name="code"会被自动注入到 Action 的code字段，无需手动 request.getParameter()；
• ${channelList}来自ChannelAddAction.java的getChannelList()方法，它查的是t_channel表所有记录。

3.2 控制层：ChannelSaveAction.java 的四步事务控制

src/com/freecms/action/admin/ChannelSaveAction.java是核心处理类。它的execute()方法精简到只有 12 行：

public String execute() throws Exception { Channel channel = new Channel(); channel.setName(name); // name 来自表单 input[name="name"] channel.setCode(code); // code 来自 input[name="code"] channel.setParentId(Integer.parseInt(parentId)); // parentId 是字符串，需转 int channel.setSortNum(0); channel.setIsShow(1); channel.setCreateTime(new Date()); channelService.save(channel); // 关键：调用 service 层 return SUCCESS; }

重点看channelService.save(channel)这一行：

• channelService是通过ApplicationContext.getBean("channelService")获取的（见父类BaseAction.java的initService()）；
• save()方法内部开启事务（TransactionTemplate.execute(...)），失败则 rollback；
• 所有字段校验（如 name 非空、code 英文）都在validate()方法里，未通过则跳回input结果页。

3.3 服务层：ChannelServiceImpl.java 的父子栏目逻辑

src/com/freecms/service/impl/ChannelServiceImpl.java的save()方法做了三件事：

public void save(Channel channel) { // 1. 如果是顶级栏目（parentId == 0），设置 path = "/0/" if (channel.getParentId() == 0) { channel.setPath("/0/"); } else { // 2. 否则查出父栏目，拼接 path = "/0/123/"（123 是父栏目 id） Channel parent = channelDao.findById(channel.getParentId()); channel.setPath(parent.getPath() + parent.getId() + "/"); } // 3. 插入数据库 channelDao.save(channel); }

这个path字段是 FreeCMS 实现无限级栏目的关键设计：

• 所有子栏目path都包含其所有祖先的 id，用/分隔；
• 查某栏目下所有子栏目，只需SELECT * FROM t_channel WHERE path LIKE '/0/123/%'；
• 删除栏目时，DELETE FROM t_channel WHERE path LIKE '/0/123/%'即可级联删干净。

3.4 持久层：ChannelDaoImpl.java 的原生 JDBC 实现

src/com/freecms/dao/impl/ChannelDaoImpl.java没用 Hibernate，是手写的 JDBC：

public void save(Channel channel) { String sql = "INSERT INTO t_channel (name,code,parent_id,path,sort_num,is_show,create_time) VALUES (?,?,?,?,?,?,?)"; Object[] params = { channel.getName(), channel.getCode(), channel.getParentId(), channel.getPath(), channel.getSortNum(), channel.getIsShow(), new Timestamp(channel.getCreateTime().getTime()) }; jdbcUtil.update(sql, params); // jdbcUtil 是封装好的 JdbcTemplate 类 }

jdbcUtil.update()内部就是标准 JDBC 流程：

• Connection conn = dataSource.getConnection();
• PreparedStatement ps = conn.prepareStatement(sql);
• ps.setString(1, params[0]); ... ps.setTimestamp(7, (Timestamp)params[6]);
• ps.executeUpdate();
• conn.close();

没有 ORM 映射，没有注解，所有 SQL 和参数位置一一对应，改起来毫无心理负担。

3.5 模板渲染：admin/channel_list.jsp 如何展示树形结构

栏目列表页WebContent/admin/channel_list.jsp用递归 JSTL 实现树形：

<c:forEach items="${channelList}" var="c"> <c:if test="${c.parentId == 0}"> <tr><td>${c.name}</td><td><a href="channel_edit.action?id=${c.id}">编辑</a></td></tr> <c:set var="childList" value="${fn:split(c.path, '/')}" /> <c:forEach items="${childList}" var="id"> <c:if test="${id != '' && id != '0'}"> <c:set var="child" value="${channelMap[id]}" /> <tr style="padding-left:20px"><td>${child.name}</td><td><a href="channel_edit.action?id=${child.id}">编辑</a></td></tr> </c:if> </c:forEach> </c:if> </c:forEach>

这里channelMap是在ChannelListAction.java中构造的Map<Integer, Channel>，key 是 id，value 是 Channel 对象，用于 O(1) 查子栏目。虽然不如现代前端虚拟滚动流畅，但在百条栏目内，响应足够快。

4. 常见问题排查：五条真实翻车记录与后悔药

FreeCMS 1.5 的报错风格很“老实”——不抛异常，只静默失败；不给提示，只返回空白页。以下是我在三台不同环境（Windows 10 + JDK 1.8、CentOS 7 + OpenJDK 1.8、macOS 12 + Temurin 1.8）上踩出的五条高频坑，每条都附带catalina.out关键日志片段和秒级修复法。

4.1 现象：后台登录成功，但点击“栏目管理”跳回登录页

日志线索：catalina.out中无 ERROR，但有DEBUG [http-bio-8080-exec-2] o.a.s2.dispatcher.Dispatcher - Unable to find 'admin/channel_list.action'
原因：struts.xml中<package name="admin" namespace="/admin" extends="struts-default">的namespace值被误删或空格，导致所有/admin/xxx.actionURL 匹配失败，Struts2 返回 404，前端 JS 捕获后跳转登录页。
解决：打开WebContent/WEB-INF/classes/struts.xml，确认第 3 行<package name="admin" namespace="/admin" ...>中namespace="/admin"完整无空格，且结尾有>。

4.2 现象：首页显示正常，但所有栏目链接点击后 404

日志线索：catalina.out出现WARN [http-bio-8080-exec-3] o.a.s2.dispatcher.Dispatcher - Could not find action or result: /index.action
原因：WebContent/index.jsp中<jsp:forward page="index.action"/>的page值写成了index.action，但struts.xml中定义的是<action name="index" class="com.freecms.action.IndexAction">，URL 正确；而index.jsp被 Tomcat 当作静态资源，未经过 Struts2 Filter。
解决：将WebContent/index.jsp改为WebContent/index.action（重命名），并在web.xml的<filter-mapping>中确保StrutsPrepareAndExecuteFilter的<url-pattern>包含*.action（默认已配）。

4.3 现象：上传图片后，前台显示http://localhost:8080/upload/2023/05/abc.jpg，但实际图片不存在

日志线索：catalina.out无报错，但upload/目录下无任何文件
原因：WebContent/WEB-INF/classes/upload.properties中upload.dir=/var/www/freecms/upload是 Linux 路径，Windows 下未改，导致FileUploadUtil.java创建目录失败，但代码里mkdirs()返回 false 后没 throw 异常，静默跳过。
解决：打开upload.properties，Windows 下改为upload.dir=D:/freecms/upload（绝对路径），并确保该目录存在且 Tomcat 进程有写权限；Linux 下确保/var/www/freecms/upload所属用户为tomcat。

4.4 现象：修改文章内容后保存，数据库更新成功，但前台仍显示旧内容

日志线索：catalina.out有DEBUG [http-bio-8080-exec-5] com.freecms.cache.EhCacheUtil - put cache key: article_123
原因：Ehcache 缓存未失效。FreeCMS 用EhCacheUtil.put("article_"+id, article)缓存文章，但ArticleSaveAction.java的save()方法末尾漏了EhCacheUtil.remove("article_"+id)。
解决：在ArticleSaveAction.java的execute()方法最后，articleService.save(article);下一行添加：

EhCacheUtil.remove("article_" + article.getId());

4.5 现象：Tomcat 启动后控制台疯狂刷WARN [main] o.a.c.h.Http11Protocol - The property [maxKeepAliveRequests] is not defined

原因：conf/server.xml中<Connector port="8080" ...>标签里写了maxKeepAliveRequests="100"，但 Tomcat 7.0.x 的Http11Protocol不支持该属性（那是 Tomcat 8+ 的Http11NioProtocol才有）。
解决：打开conf/server.xml，找到<Connector>标签，删掉maxKeepAliveRequests="100"整个属性（保留port,protocol,connectionTimeout等必要项即可）。

5. 二次开发实战：给栏目管理页加“是否启用”开关（含前后端完整改造）

FreeCMS 1.5 默认所有栏目都启用，没有“停用”功能。但实际业务中，常需要临时下线某个栏目（比如“招聘专栏”招满人后不想删数据只想隐藏）。下面我带你从数据库字段加起，一路改到后台按钮，全程不碰 Struts2 配置，所有改动都在src/和WebContent/下完成，改完重启 Tomcat 即生效。

5.1 数据库层：新增 is_enabled 字段并补全默认值

FreeCMS 的栏目表t_channel缺少启用开关字段。执行 SQL：

ALTER TABLE t_channel ADD COLUMN is_enabled TINYINT(1) DEFAULT 1 COMMENT '是否启用：1启用，0停用'; UPDATE t_channel SET is_enabled = 1 WHERE is_enabled IS NULL;

注意：TINYINT(1)是 MySQL 存布尔值的标准做法，Java 里映射为int或boolean（MyBatis 会自动转换）。

5.2 实体层：Channel.java 新增字段与 getter/setter

打开src/com/freecms/entity/Channel.java，在字段区加：

private int isEnabled; // 新增字段 // ... 其他字段保持不变

在方法区加：

public int getIsEnabled() { return isEnabled; } public void setIsEnabled(int isEnabled) { this.isEnabled = isEnabled; }

5.3 DAO 层：ChannelDaoImpl.java 更新 insert 和 update SQL

ChannelDaoImpl.java的save()方法中，INSERT SQL 补上is_enabled：

// 原 SQL（第 1 行）： // String sql = "INSERT INTO t_channel (name,code,parent_id,path,sort_num,is_show,create_time) VALUES (?,?,?,?,?,?,?)"; // 改为： String sql = "INSERT INTO t_channel (name,code,parent_id,path,sort_num,is_show,is_enabled,create_time) VALUES (?,?,?,?,?,?,?,?)"; // 原 params（第 2 行）： // Object[] params = { ..., channel.getIsShow(), channel.getCreateTime() }; // 改为： Object[] params = { ..., channel.getIsShow(), channel.getIsEnabled(), new Timestamp(channel.getCreateTime().getTime()) };

同理，update()方法中 UPDATE SQL 也要加is_enabled = ?和对应params位。

5.4 Service 层：ChannelServiceImpl.java 透传字段

ChannelServiceImpl.java的save()和update()方法中，channel.setIsEnabled(...)已由 Action 注入，DAO 层会自动取值，此处无需改。

5.5 Action 层：ChannelAddAction.java 和 ChannelEditAction.java 补字段接收

ChannelAddAction.java中加字段：

private int isEnabled = 1; // 默认启用 public int getIsEnabled() { return isEnabled; } public void setIsEnabled(int isEnabled) { this.isEnabled = isEnabled; }

ChannelEditAction.java同理，并在execute()方法中channel.setIsEnabled(isEnabled);。

5.6 前端层：三处 JSP 改造实现开关控件

① 添加页channel_add.jsp：在code输入框下方加：

<tr> <td>是否启用：</td> <td> <input type="radio" name="isEnabled" value="1" checked/> 启用 <input type="radio" name="isEnabled" value="0"/> 停用 </td> </tr>

② 编辑页channel_edit.jsp：在code下方加：

<tr> <td>是否启用：</td> <td> <input type="radio" name="isEnabled" value="1" <c:if test="${channel.isEnabled == 1}">checked</c:if>/>&nbsp;启用 <input type="radio" name="isEnabled" value="0" <c:if test="${channel.isEnabled == 0}">checked</c:if>/>&nbsp;停用 </td> </tr>

③ 列表页channel_list.jsp：在栏目名后加状态标签：

<td> ${c.name} <c:if test="${c.isEnabled == 0}"> <span style="color:red; font-size:12px;">[已停用]</span> </c:if> </td>

5.7 前端过滤：让停用栏目不显示在前台导航

FreeCMS 前台导航由IndexAction.java的execute()方法加载channelList，它调用channelService.findAll()。我们需要改ChannelDaoImpl.java的findAll()方法，加 where 条件：

// 原 SQL： // String sql = "SELECT * FROM t_channel ORDER BY sort_num DESC"; // 改为： String sql = "SELECT * FROM t_channel WHERE is_enabled = 1 ORDER BY sort_num DESC";

这样，停用栏目既不会出现在后台列表页的[已停用]标签里（因为channel_list.jsp仍查全部），也不会出现在前台导航中（因为IndexAction查的是is_enabled = 1的数据）。

从改数据库字段到前台可见，共 7 处改动，全部在项目自有目录下，不引入新 jar，不改框架配置。我一般会在改完 DAO 层后，先写个测试类TestChannelDao.java，手动 newChannelDaoImpl()，调findAll()看 SQL 打印是否带WHERE is_enabled = 1，再启动 Tomcat。从那以后我每次加字段，都强制走一遍“DB → Entity → DAO → Service → Action → JSP”全链路验证，哪怕只是加个create_by字段。希望帮到你。

本文还有配套的精品资源，点击获取