适用人群
本文写给谁？——有Java基础但没玩过JEECMS的新手，或者你之前用过其他CMS（比如WordPress、DedeCMS）想转Java生态的老手，你要是连JDK、Maven、MySQL都还没装好，那请你先闭嘴，去百度安装教程，装完再回来看，我这里不教环境安装，只教你怎么把JEECMS跑起来并搭出一个像样的网站，如果你是纯前端小白，连IDE是什么都不知道，建议你先报个Java入门班，别浪费时间看这篇。
完整搭建步骤（别跳步，跳一步你就卡死）
第一步：下载源码并导入IDE
去Gitee或官网搜“JEECMS”，找一个稳定版本（推荐v9.x或v10.x系列），下载zip包，解压，打开你的IntelliJ IDEA（别用Eclipse，别问为什么，因为我烦它），点击“File → Open”，选择解压后的目录，等Maven下载依赖，这个过程可能要10分钟，去喝杯咖啡，别盯着进度条看，没用。
第二步：创建数据库
打开MySQL命令行或Navicat,执行：
CREATE DATABASE jeecms DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
注意！字符集一定要是utf8mb4，否则后期存表情包或特殊符号会报错，别问我怎么知道的，我帮人擦屁股擦了几百次了。
JEECMS从零搭站，30分钟搞定企业官网，别跟我说你不行
第三步：修改配置文件
找到 src/main/resources/application-dev.yml（或application.yml），别找错了，用你该死的眼睛看清楚：
server:
port: 8080 # 如果8080被占用了，改成8081，但下面所有地方都要对应改
spring:
datasource:
url: jdbc:mysql://localhost:3306/jeecms?useUnicode=true&characterEncoding=utf-8&serverTimezone=Asia/Shanghai
username: root
password: 你的密码
# 文件上传路径，别偷懒用默认
jeecms:
upload-path: /data/jeecms/upload # Linux路径，Windows写D:/jeecms/upload
配置要点：
spring.datasource.url后面一定要加useSSL=false？不一定，看你的MySQL版本，但最好加上&useSSL=false&allowPublicKeyRetrieval=true，否则新版MySQL会报错。jeecms.upload-path这个目录必须存在，提前手动创建好，并且要有读写权限，否则上传图片时你会看到白屏，然后来骂我。- 还有
jeecms.domain？如果你用默认localhost，那就不用配，如果要绑定正式域名，必须在application-prod.yml里配好，否则后台登录会session失效。
第四步：初始化数据库表
打开 doc/db 目录，找到jeecms*.sql文件（可能有多个，按版本顺序执行），用Navicat运行这些SQL语句，注意！先运行核心表，再运行插件表，顺序错了会导致外键约束报错，如果你懒，可以直接用项目自带的Flyway自动迁移——但前提是你在配置里打开 spring.flyway.enabled=true ，我建议新手手动跑SQL，至少你能知道表长什么样。
第五步：启动项目
在IDEA中找到主类（一般是 com.jeecms.JeecmsApplication），右键 Run，看控制台日志，如果出现 Started JeecmsApplication in 12.345 seconds 说明启动成功，如果报错 端口被占用，那么回到第三步改端口；如果报错 数据库连接失败，检查你的MySQL服务是否启动、用户名密码是否写对；如果报错 ClassNotFoundException，那就是Maven依赖没下载全，在Terminal执行 mvn clean install -DskipTests 重新编译。
第六步：后台登录和基础配置
浏览器访问 http://localhost:8080/jeecms （注意路径，有的版本是 /jeecms/ 或 /admin，看具体版本说明），默认管理员账号 admin，密码 admin123，登录进去后，第一件事——改密码！不改等着被黑客日穿吧，第二件事：进“站点管理”添加一个站点，填域名（如果是本地就填 localhost:8080），模板选择默认，第三件事：去“栏目管理”创建几个栏目，关于我们”、“新闻动态”，然后发布一篇文章试试。
常见踩坑提醒（你大概率会遇到的，别不信）
-
坑1：后台页面白屏或样式丢失
原因：静态资源路径没配好，检查application.yml里jeecms.static.path是否正确，或者你是不是把项目当成普通Spring Boot直接访问了？JEECMS的静态资源需要映射，默认是classpath:/static/，千万别删掉这个配置，如果用了Nginx反向代理，记得把代理路径也配上。 -
坑2：上传图片后不显示
原因99%是上传路径不存在或权限不够，去服务器上ls -l /data/jeecms/upload看看目录属主，确保和启动项目的用户一致，Windows用户注意：路径中的反斜杠要写成D:/jeecms/upload而不是D:\jeecms\upload，这个能坑死一票人。 -
坑3：模板无法加载
你下载的demo模板可能放在WEB-INF/templates下面，但你改了模板目录？去后台“模板管理”看看路径是否匹配，常见错误：模板文件名大小写不对，Linux系统严格区分大小写，index.html和Index.html是俩东西。 -
坑4：部署到服务器后session失效
这是老生常谈了，JEECMS使用Redis或数据库存储session，如果你没有配置Redis，那默认是用本地内存，多台服务器部署就会串session，解决办法：在配置里加上spring.session.store-type=jdbc或者直接上Redis，域名和IP不一致也会导致session丢失，后台登录后跳回首页就退出——去检查jeecms.domain是否配置了正确的访问域名。 -
坑5：安装插件（如会员系统、商城）后出现404
插件路径和主项目路径冲突，这时候需要调整jeecms.plugin.path或者把插件里的@RequestMapping改成统一前缀，新手别自作聪明改源码，先看官方文档的插件部署说明。
收尾
行了,按照上面的步骤走下来，你的JEECMS网站应该已经跑起来了。别问我为什么有些版本菜单不一样，因为JEECMS分免费版和商业版，免费版功能阉割不少，比如没有可视化编辑、没有静态化，如果你要正式上线，建议要么买商业版，要么自己二次开发，最后提醒一句：开发时用DEBUG模式，上线务必改成PROD模式，并关闭所有不必要的接口，就这么着，自己去动手，别光收藏不实践，再问我这种基础问题我就拉黑你。
发表评论