适用人群:完全没接触过JEECMS的建站新手、想快速搭建企业官网或内部信息门户的运营人员、刚入门JavaWeb开发但想用成熟CMS省力的学生,只要你会上网、会解压压缩包、会改文字,就能跟着本教程把网站跑起来——不需要你懂Spring框架,也不要求你写过Java代码。
第一步:准备环境,别让版本坑了你
先装好这些东西:JDK 8(别用JDK 11以上,很多老版本JEECMS会报错)、MySQL 5.7(8.0也行,但连接驱动要换)、Tomcat 8.5(Tomcat 9也能用,但别用10,包名都变了),装完在命令行敲java -version和mysql --version确认好。

从零到上线,JEECMS开发实战手把手教程,新手也能搭出企业官网
下载JEECMS源码包(开源版或商业版看你自己),解压后你会看到两个关键目录:web是网站前端模板,src是Java后台代码,如果你是纯新手,建议直接用官方提供的完整包,别自己从零建项目。
第二步:导入数据库,这是最容易出错的一步
打开MySQL,执行jeecms.sql脚本(一般在db目录下),注意:必须用UTF-8编码执行!否则中文全变乱码,命令行执行:
mysql -u root -p --default-character-set=utf8 < jeecms.sql
导入成功后,用Navicat能看见几十张表,别慌,你只需要知道jc_user是管理员表,jc_site是站点配置表就够用了。
第三步:改配置文件,三处必改
打开src/jeecms.properties(或application.properties),找到这三项:
jdbc.url:改成你的数据库地址,比如jdbc:mysql://localhost:3306/jeecms?useUnicode=true&characterEncoding=UTF8jdbc.username和jdbc.password:填你自己的数据库账号密码site.domain:这个是你未来访问的域名,本地测试就填localhost
改完保存,用Eclipse或IDEA将项目打成WAR包(或用官方自带的部署目录),把WAR包扔进Tomcat的webapps,启动Tomcat,等控制台出现信息: Server startup in XXXX ms就成功了。
第四步:访问后台,开始搭页面
浏览器输入http://localhost:8080/jeecms/,进入前台,后台地址是http://localhost:8080/jeecms/jeeadmin/jeecms/login.do,默认账号密码是admin和password(赶紧改掉)。
后台界面分三大块:栏目管理、内容模型、模板管理,新手最容易懵的是“模板”和“栏目”的关系,打个比方:模板就是毛坯房的户型图,栏目是房间的门牌号,内容是房间里的家具,你得先有户型图(模板),再挂门牌(栏目),最后往里面摆家具(内容)。
搭建步骤:
- 在“模板管理”里创建一个模板文件,比如
index.html,里面可以写HTML标签。 - 在“栏目管理”里新建一个栏目,公司新闻”,并绑定你刚创建的模板,管理”里点“添加内容”,选择对应栏目,填标题和正文。
- 去前台刷新页面,你就能看到文章了。
第五步:配置要点——导航栏和首页
想让导航栏显示哪些栏目?在“栏目管理”里调整排序和“是否显示在导航”,想改首页布局?直接改模板文件,JEECMS的模板用FreeMarker标签,比如[@cms_channel_list]可以循环输出栏目列表,[@cms_content_list]可以输出文章列表,这些标签不用背,复制官方示例改ID就行。
常见踩坑提醒
- 乱码问题:90%是导入SQL时没加
--default-character-set=utf8,或者连接URL没写characterEncoding=UTF8。 - 404错误:先检查栏目绑定模板了没,其次看模板文件名是不是以
.htmlJEECMS默认只渲染.html)。 - 后台500错误:看看是不是Tomcat内存不足,在
catalina.bat里加上set JAVA_OPTS=-Xmx512m。 - 图片上传失败:检查部署目录下
upload文件夹是否可写,Windows下右键属性取消“只读”,Linux下执行chmod 777 -R upload。 - 前台空白:十有八九是模板报错,打开浏览器的开发者工具F12,看控制台的500报错信息,定位到模板第几行。
最后一步:上线发布
本地跑通后,把数据库导出,再在新服务器上导入一遍,把模板和upload目录一起打包,传到服务器的Tomcat webapps下,记得把配置文件里的数据库地址和域名改成生产环境的。
跟着做,你就能在半小时内用JEECMS搭建出一个能发布新闻、产品、下载资料的完整网站,遇到报错别慌,先看日志,再看我上面总结的坑——绝大多数问题都出在编码和模板绑定上,去下载一个JEECMS练手吧。
发表评论