WSO2 API Manager 4.1管理控制台无法强制重启求助

问题背景 #

以管理员身份登录WSO2 API Manager 4.1管理控制台时无法强制重启，服务启动失败，核心报错日志如下：

[2022-10-01 00:45:08,095] ERROR - DefaultRealm nullType class java.lang.reflect.InvocationTargetException
org.wso2.carbon.user.core.UserStoreException: nullType class java.lang.reflect.InvocationTargetException
        ...
Caused by: org.wso2.carbon.user.core.UserStoreException: DB error occurred while persisting domain : PRIMARY & tenant id : -1234
        ...

根本原因分析 #

日志明确指向数据库操作失败，无法将PRIMARY域持久化到数据库，导致用户存储初始化失败，服务启动中断。常见诱因包括：

• 数据库连接配置错误（URL、用户名、密码无效）
• 数据库服务未正常运行
• WSO2数据库用户缺乏UM_DOMAIN表的读写权限
• 数据库表缺失（如UM_DOMAIN未创建）

修复步骤 #

1. 验证数据库连接

   • 打开<APIM_HOME>/repository/conf/datasources/master-datasources.xml，核对数据库URL、用户名、密码配置。
   • 用数据库客户端直接测试连接，例如MySQL：

     mysql -u <db_username> -p -h <db_host> <db_name>
     

     确认能正常登录并执行查询。

2. 检查数据库权限与表结构

   • 确保WSO2使用的数据库用户对UM_DOMAIN表拥有SELECT、INSERT、UPDATE权限。
   • 若UM_DOMAIN表不存在，重新执行<APIM_HOME>/dbscripts/apim.sql（对应数据库的初始化脚本）。

3. 清理缓存

   • 删除临时文件与缓存目录：

     rm -rf /opt/source/wso2_binary/wso2am-4.1.0/tmp/*
     rm -rf /opt/source/wso2_binary/wso2am-4.1.0/repository/conf/identity/.cache/*
     

Linux命令行重启方案 #

若管理控制台无法操作，直接通过命令行强制重启服务：

1. 查找WSO2进程ID

   ps aux | grep wso2am-4.1.0
   

   或通过端口定位（默认HTTPS端口9443）：

   netstat -tulpn | grep 9443
   

2. 强制终止进程

   kill -9 <PID>
   

   替换<PID>为上一步查到的进程ID。

3. 启动服务

   cd /opt/source/wso2_binary/wso2am-4.1.0/bin
   ./wso2server.sh start
   

4. 实时查看启动日志

   tail -f /opt/source/wso2_binary/wso2am-4.1.0/repository/logs/wso2carbon.log
   

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