DSpace新用户注册提示Internal system error的原因及解决方法

故障特征：存量已注册用户可正常登录，仅新用户注册流程返回"Internal system error"，故障范围限定在注册写入链路，不涉及全局账号认证逻辑

常见诱因及对应修复操作 #

• 诱因1：注册关联的SMTP邮件服务异常
  DSpace默认注册逻辑要求提交信息后发送验证邮件，该环节如果SMTP配置错误、端口被防火墙拦截、发件账号鉴权失败，会抛出未捕获的内部错误；老用户登录不触发邮件发送流程，因此完全不受影响。
  修复步骤：
  1. 打开配置文件，6.x及更早版本为[dspace安装目录]/config/dspace.cfg，7.x及以上版本为[dspace安装目录]/config/local.cfg，核对mail.server、mail.server.port、mail.from.address、mail.server.username、mail.server.password配置项和可用SMTP服务参数是否一致
  2. 服务器端执行连通性校验：telnet <SMTP服务地址> <SMTP端口>，排除防火墙、安全组拦截问题
  3. 临时关闭注册邮件验证做定位：将配置项registration.notify设为false，重启DSpace服务后尝试注册，如果流程恢复正常即可确认是邮件链路问题，修复SMTP配置后再重新开启验证即可。
• 诱因2：eperson用户表主键序列错位
  DSpace用户数据存储在数据库eperson表中，如果此前做过批量数据导入、手动修改表数据，可能导致表绑定的自增主键序列当前值小于表中已存在的最大ID，新用户写入时触发主键重复错误，直接返回内部错误；老用户登录仅做查询校验，不触发写入操作因此不受影响。
  修复步骤：
  1. 连接DSpace使用的PostgreSQL数据库，执行语句查询当前最大用户ID：SELECT MAX(eperson_id) FROM eperson;
  2. 查询主键序列当前值：SELECT nextval('eperson_eperson_id_seq');
  3. 如果序列返回值小于步骤1查到的最大ID，重置序列到正确值：SELECT setval('eperson_eperson_id_seq', <步骤1查到的最大ID值>);
  4. 额外校验eperson表email字段的唯一索引，确认不存在重复空值、脏数据阻断新记录写入。
• 诱因3：注册链路挂载的自定义插件报错
  如果部署的DSpace做过二次开发，在注册完成事件钩子上挂载了自定义逻辑（比如自动分配用户组、同步第三方系统账号、风控校验），当插件依赖的接口不可用、出现未捕获的空指针等异常时，会中断整个注册流程返回内部错误；登录流程不触发这些钩子逻辑，因此不受影响。
  修复步骤：
  1. 打开日志文件[dspace安装目录]/log/dspace.log，检索注册请求时间点附近的ERROR级别堆栈信息，定位具体报错的类和代码行
  2. 临时禁用报错的自定义插件，测试注册流程恢复正常后，修复插件的异常捕获逻辑、补全依赖配置再重新启用。

排查提示：优先查对应时间点的错误日志，可直接定位根因，无需盲目逐一试错。检索日志时可匹配关键词/register或Internal Server Error快速过滤相关日志条目。

内容的提问来源于stack exchange，提问作者Олег Гуцуляк