Liferay编程创建站点调用addGroup方法报GroupKeyException如何解决

这个GroupKeyException由Liferay的站点键校验逻辑抛出，属于addGroup方法的参数配置错误，触发原因有以下几个常见情况：

• groupKey参数为空：你调用方法时传入的第三个参数为空字符串""，groupKey是站点的全局唯一标识，不允许为空，你可以直接用站点名称hilversum作为该参数的值。
• 友好URL重复：如果当前Liferay实例中已经存在使用/hilversum作为友好路径的站点，也会触发该校验异常，可以先去后台站点管理页确认是否有重复的站点。
• ServiceContext配置错误：你直接通过new ServiceContext()创建的上下文缺少必要的请求、权限、公司ID等信息，即使通过groupKey校验也会大概率触发后续异常，正确做法是从当前请求中提取ServiceContext。
• 站点类别ID无效：你传入的37632是站点分类的ID，需要确认该ID在你的Liferay实例中真实存在，不存在也会触发相关校验报错。

public void addGroup(ActionRequest request, ActionResponse response)  {
    ThemeDisplay theme = (ThemeDisplay) request.getAttribute(WebKeys.THEME_DISPLAY);  
    long userId = theme.getUserId();
    // 定义非空的唯一groupKey
    String groupKey = "hilversum";
    String friendly = "/hilversum";
    String name = "hilversum";
    Map<Locale, String> nameMap = new HashMap<Locale, String>();
    nameMap.put(LocaleUtil.NETHERLANDS, name);
    
    try {
        // 从请求中获取正确的ServiceContext
        ServiceContext serviceContext = ServiceContextFactory.getInstance(request);
        GroupLocalServiceUtil.addGroup(
            userId, 
            GroupConstants.DEFAULT_PARENT_GROUP_ID, 
            groupKey, // 替换空字符串为有效groupKey
            37632,
            GroupConstants.DEFAULT_LIVE_GROUP_ID, 
            nameMap, 
            null, 
            GroupConstants.TYPE_SITE_OPEN, 
            false, 
            GroupConstants.DEFAULT_MEMBERSHIP_RESTRICTION, 
            friendly, 
            true, 
            true, 
            serviceContext
        );
    } catch (PortalException e) {
        e.printStackTrace();
    }
}

可以在创建站点前先判断是否已经存在对应友好路径的站点，避免重复创建报错：

// 先查询是否存在同友好路径的站点
Group existGroup = GroupLocalServiceUtil.fetchFriendlyURLGroup(theme.getCompanyId(), friendly);
if (existGroup != null) {
    // 自行处理站点已存在的业务逻辑，比如返回提示给前端
    return;
}

内容的提问来源于stack exchange，提问作者Lincolnmyth