常见问题

新增站点并发布文章

开启站群配置，并设置站群涉及表(cms_content,cms_category)；在站点管理进行appId初始化，成功后可在站群涉及表看到新增的app_id字段
新增站点，站点域名本地可用127、192、localhost做3个测试站；如需要更多，可以使用代理工具配置代理；内网配置参考

// 代理参考
a.demo.com localhost:8080
b.demo.com localhost:8080

新站点的模板文件，头部切换到新站点后，在系统设置->模板管理处上传，也可以直接创建template/站点id/模板文件夹
文章分发，将站点的文章分发到其他站点，只能分发终审通过的文章

访问系统提示站点不存在

更改ShiroConfig :

   注释public ManagerAuthRealm customRealm(SimpleCredentialsMatcher managerLoginCredentialsMatcher)
   
   打开public BaseAuthRealm customRealm(SimpleCredentialsMatcher managerLoginCredentialsMatcher)

Tip

请优先确认自己的访问地址是否与站点域名一致 !

站群https域名问题

部署https域名，站群配置中的域名推荐统一都部署为https,开启yml中https配置参考
如果有使用nginx之类的做代理，不需要配置端口代理，nginx配置参考文档

站群功能未生效

在pom依赖中，站群依赖要放在其他所有模块依赖的前面，若加载顺序不对就会导致站群功能无法正常生效。

更换站点目录

需要重新静态化，并对原目录进行删除，避免通过老路径访问

主界面切换站点按钮不显示

1.将主界面注释的代码放开

通过搜索site关键字可快速定位，应有3处注释，下图为一处示例

2.在站群配置中启用站群

nginx环境下，未登录访问静态页面500，登录后访问正常

nginx代理没有把请求头携带过去参考nginx代理配置

接口忽略站群,sql不拼接appId

需要手写xml，并在dao层方法上使用@InterceptorIgnore(tenantLine = "true")注解


// IXxxxDao  

// 非分页方法，不使用BasicUtil.startPage()开启分页
@InterceptorIgnore(tenantLine = "true")
void ignoreSiteWithoutPaginate();


// 分页方法，使用BasicUtil.startPage()开启分页
// 由于pageHelper和mp的多租户插件有冲突，分页查询count时仍会拼接appId导致总数查询错误
// https://github.com/baomidou/mybatis-plus/issues/4577

@InterceptorIgnore(tenantLine = "true")
List<XXX> ignoreSiteWithPaginate();

// 手动声明count方法解决，以下为示例 ， 无需编写xml   
@InterceptorIgnore(tenantLine = "true")
long ignoreSiteWithPaginate_COUNT();