macOS系统全新安装Apache Directory Studio无法启动新建LDAP服务器

排查解决步骤 #

• 检查端口占用
  Apache DS默认使用10389（LDAP）、10636（LDAPS）端口，先在终端执行命令查看是否被其他进程占用：
  sudo lsof -i :10389
  如果返回对应进程信息，杀掉冲突进程，或者在服务器配置中修改为未被占用的端口即可。
• 确认Java版本匹配
  2.0.0-M17版本仅兼容Java 11，过高或过低的Java版本都会导致启动失败。先在终端执行java -version确认当前Java版本，不符合要求就安装OpenJDK 11，之后编辑ApacheDirectoryStudio.ini文件，在-vmargs行之前增加JDK路径指定配置：

  -vm
  /Library/Java/JavaVirtualMachines/adoptopenjdk-11.jdk/Contents/Home/bin/java
  

• 重建服务器实例
  现有实例可能存在配置损坏，直接在LDAP服务器列表中删除当前的default实例，重新创建新的服务器实例，创建时保持默认配置先测试启动。
• 修复界面日志不显示问题
  日志面板默认过滤了低级别日志，点击日志面板右上角的下拉三角，选择「Configure Logs」，将日志级别调整为INFO或DEBUG，即可正常显示启动日志。
• 版本降级
  2.0.0-M17为预发布版本，存在大量未修复的兼容性bug，在macOS 10.15系统上故障高发。如果上述操作都无效，降级到2.0.0-M16稳定版本即可解决问题。

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