无法访问Marklogic DHF，出现8010连接错误求助

问题描述 #

按照MarkLogic DHF 6快速入门指南搭建环境，在localhost:8080输入用户名密码回车后出现连接错误，核心错误为java.net.ConnectException: Failed to connect to localhost/127.0.0.1:8010，完整错误日志如下：

2023-11-11 23:20:40.029 [http-nio-8080-exec-1] INFO  o.a.c.c.C.[Tomcat].[localhost].[/] - Initializing Spring DispatcherServlet 'dispatcherServlet'
2023-11-11 23:20:41.219 [main] INFO  c.marklogic.hub.central.Application - Started Application in 14.615 seconds (JVM running for 15.403)
2023-11-11 23:20:48.885 [http-nio-8080-exec-7] INFO  com.marklogic.hub.impl.HubConfigImpl - Could not find the datahubConfig.json file. Logging the cause for the failure
2023-11-11 23:20:48.887 [http-nio-8080-exec-7] INFO  com.marklogic.hub.impl.HubConfigImpl - java.net.ConnectException: Failed to connect to localhost/127.0.0.1:8010
2023-11-11 23:20:49.357 [http-nio-8080-exec-7] INFO  c.m.a.DefaultAppConfigFactory - App host: localhost
2023-11-11 23:20:49.358 [http-nio-8080-exec-7] INFO  c.m.a.DefaultAppConfigFactory - REST admin username: admin
2023-11-11 23:20:49.360 [http-nio-8080-exec-7] INFO  c.m.a.DefaultAppConfigFactory - App Services username: admin
2023-11-11 23:20:49.375 [http-nio-8080-exec-7] INFO  c.m.m.a.DefaultAdminConfigFactory - Admin interface host: localhost
2023-11-11 23:20:49.378 [http-nio-8080-exec-7] INFO  c.m.m.a.DefaultAdminConfigFactory - Admin interface username: admin
2023-11-11 23:20:49.403 [http-nio-8080-exec-7] INFO  c.m.mgmt.DefaultManageConfigFactory - Manage host: localhost
2023-11-11 23:20:49.405 [http-nio-8080-exec-7] INFO  c.m.mgmt.DefaultManageConfigFactory - Manage username: admin
2023-11-11 23:20:49.407 [http-nio-8080-exec-7] INFO  c.m.mgmt.DefaultManageConfigFactory - Manage user with security role: admin
2023-11-11 23:20:49.728 [http-nio-8080-exec-7] INFO  com.marklogic.mgmt.ManageClient - Initializing ManageClient with manage config of: [ManageConfig host: localhost, port: 8002, username: admin, security username: admin]
2023-11-11 23:20:49.827 [http-nio-8080-exec-7] INFO  com.marklogic.mgmt.ManageClient - Initializing ManageClient with manage config of: [ManageConfig host: localhost, port: 8002, username: admin, security username: admin]
2023-11-11 23:20:51.941 [http-nio-8080-exec-7] ERROR o.a.c.c.C.[.[.[.[dispatcherServlet] - Servlet.service() for servlet [dispatcherServlet] in context with path [] threw exception
com.marklogic.client.MarkLogicIOException: java.net.ConnectException: Failed to connect to localhost/127.0.0.1:8010
        at com.marklogic.client.impl.OkHttpServices.sendRequestOnce(OkHttpServices.java:704)
        at com.marklogic.client.impl.OkHttpServices.sendRequestOnce(OkHttpServices.java:697)

使用环境：

• DHF version 6
• MarkLogic version 10.0-10.2
• Java: 1.8

排查步骤 #

1. 确认MarkLogic服务状态 #

检查MarkLogic是否正常启动，可通过访问localhost:8001（管理控制台）验证，若无法访问则先启动MarkLogic服务。

2. 检查8010端口可用性 #

8010是DHF默认的staging数据库REST API端口，需确认该端口是否被MarkLogic占用：

• Windows系统执行命令：netstat -ano | findstr :8010
• Linux/macOS系统执行命令：lsof -i :8010 或 netstat -tulpn | grep :8010
  若端口未被占用，说明DHF所需的staging REST API服务未创建，需完成初始化配置。

3. 重新执行DHF初始化 #

确保已完成DHF项目初始化，若跳过相关步骤，运行以下命令（需在项目目录下执行）：

./gradlew mlDeploy

该命令会在MarkLogic中自动创建所需的数据库、REST API服务（含8010端口的staging服务）及相关角色权限。

4. 验证端口配置一致性 #

检查DHF项目中的gradle.properties或datahubConfig.json文件，确认staging端口配置为8010，若有修改需与MarkLogic中已创建的REST API服务端口保持一致。

5. 防火墙/网络检查 #

确认本地防火墙未阻止8010端口的通信，可临时关闭防火墙测试连接是否恢复。

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