[Bug] 最新版的docker 镜像启动失败

[shell-nlp]

Bug Type (问题类型)

server status (启动/运行异常)

Before submit

• 我已经确认现有的 Issues 与 FAQ 中没有相同 / 重复问题 (I have confirmed and searched that there are no similar problems in the historical issue and documents)

Environment (环境信息)

• Server Version: 1.0.0 (Apache Release Version)
• Backend: RocksDB x nodes, HDD or SSD
• OS: xx CPUs, xx G RAM, Ubuntu 2x.x / CentOS 7.x
• Data Size: xx vertices, xx edges

Expected & Actual behavior (期望与实际表现)

镜像信息:
hugegraph/hugegraph:latest
sha256:ac50bbca0b5288e6b9cf4d67d371cbf6135916b43821715c47527bd568f275a0

init hugegraph with auth mode
Initializing HugeGraph Store...
2025-11-11 09:36:18 [main] [WARN] o.a.h.c.HugeConfig - The config option 'arthas.telnet_port' is redundant, please ensure it has been registered
2025-11-11 09:36:18 [main] [WARN] o.a.h.c.HugeConfig - The config option 'arthas.http_port' is redundant, please ensure it has been registered
2025-11-11 09:36:18 [main] [WARN] o.a.h.c.HugeConfig - The config option 'arthas.disabled_commands' is redundant, please ensure it has been registered
2025-11-11 09:36:18 [main] [INFO] o.a.h.u.ConfigUtil - Scanning option 'graphs' directory './conf/graphs'
2025-11-11 09:36:18 [main] [INFO] o.a.h.c.InitStore - Init graph with config file: /hugegraph-server/conf/graphs/hugegraph.properties
Exception in thread "main" java.lang.ExceptionInInitializerError
        at java.base/java.lang.Class.forName0(Native Method)
        at java.base/java.lang.Class.forName(Unknown Source)
        at org.apache.tinkerpop.gremlin.structure.util.GraphFactory.open(GraphFactory.java:63)
        at org.apache.hugegraph.cmd.InitStore.initGraph(InitStore.java:109)
        at org.apache.hugegraph.cmd.InitStore.main(InitStore.java:93)
Caused by: java.lang.reflect.InaccessibleObjectException: Unable to make public static synchronized void jdk.internal.reflect.Reflection.registerMethodsToFilter(java.lang.Class,java.lang.String[]) accessible: module java.base does not "exports jdk.internal.reflect" to unnamed module @7cd1ac19
        at java.base/java.lang.reflect.AccessibleObject.checkCanSetAccessible(Unknown Source)
        at java.base/java.lang.reflect.AccessibleObject.checkCanSetAccessible(Unknown Source)
        at java.base/java.lang.reflect.Method.checkCanSetAccessible(Unknown Source)
        at java.base/java.lang.reflect.Method.setAccessible(Unknown Source)
        at org.apache.hugegraph.util.Reflection.registerMethodsToFilter(Reflection.java:84)
        at org.apache.hugegraph.auth.HugeFactoryAuthProxy.filterCriticalSystemClasses(HugeFactoryAuthProxy.java:488)
        at org.apache.hugegraph.auth.HugeFactoryAuthProxy.registerPrivateActions(HugeFactoryAuthProxy.java:98)
        at org.apache.hugegraph.auth.HugeFactoryAuthProxy.<clinit>(HugeFactoryAuthProxy.java:78)
        ... 5 more
Initialization finished.
Starting HugeGraphServer in daemon mode...
Connecting to HugeGraphServer (http://0.0.0.0:8080/graphs).....Starting HugeGraphServer failed
See /hugegraph-server/logs/hugegraph-server.log for HugeGraphServer log output.

Vertex/Edge example (问题点 / 边数据举例)

Schema [VertexLabel, EdgeLabel, IndexLabel] (元数据结构)

[dosubot]

你的问题是由于 Java 11+ 的模块系统限制导致的（InaccessibleObjectException），HugeGraph 在启动时需要访问 JDK 的内部 API，但当前 Docker 镜像的启动脚本没有自动加上必要的 JVM 参数。这个参数是：

--add-exports=java.base/jdk.internal.reflect=ALL-UNNAMED

你可以通过设置环境变量 JAVA_OPTS，让 HugeGraph 在 Docker 启动时带上这个参数。例如：

docker run -itd --name=graph -p 8080:8080 \
  -e JAVA_OPTS="--add-exports=java.base/jdk.internal.reflect=ALL-UNNAMED" \
  hugegraph/hugegraph:latest

这样可以绕过 Java 模块的访问限制，避免启动时报错。相关说明和修复建议见此 issue。

另外，官方建议生产环境使用具体的 release tag（如 hugegraph/hugegraph:1.5.0），而不是 latest，以保证镜像的稳定性和兼容性。参考文档。

如需进一步排查，可查看容器内 /hugegraph-server/logs/hugegraph-server.log 获取详细日志。

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}    

[shell-nlp]

启动的docker compose 如下：

version: '3'
services:
  server:
    image: docker.1ms.run/hugegraph/hugegraph:latest
    container_name: server
    environment:
      - PASSWORD=hugegraph@2025
    #  - PASSWORD=xxx 为可选参数，设置的时候可以开启鉴权模式，并设置密码
      - PRELOAD=true
    #  - PRELOAD=true 为可选参数，为 True 时可以在启动的时候预加载一个内置的样例图
    ports:
    # swagger: http://localhost:8080/swagger-ui/index.html
      - 58080:8080

我发现如果 去掉 environment的 - PASSWORD=hugegraph@2025 是正常启动的

[dosubot]

你遇到的启动失败，是因为设置了 PASSWORD（开启鉴权模式）和 PRELOAD（预加载样例图）后，HugeGraph 会走认证和样例数据初始化的代码路径，这些路径需要访问 JDK 的内部 API（如 jdk.internal.reflect.Reflection.registerMethodsToFilter），但 Java 11+ 默认禁止访问这些内部模块，导致 InaccessibleObjectException 抛错，容器无法正常启动。相关源码分析

解决方法：在 Docker Compose 的环境变量里加上 JVM 参数，允许访问 JDK 内部 API。具体做法如下：

version: '3'
services:
  server:
    image: docker.1ms.run/hugegraph/hugegraph:latest
    container_name: server
    environment:
      - PASSWORD=hugegraph@2025
      - PRELOAD=true
      - JAVA_OPTS=--add-exports=java.base/jdk.internal.reflect=ALL-UNNAMED
    ports:
      - 58080:8080

这样 HugeGraph 启动时就能访问需要的 JDK 内部 API，避免报错。如果你用的是生产环境，建议用官方 release tag 镜像（如 hugegraph/hugegraph:1.5.0），不要用 latest，以保证稳定性。

如果还有其他报错，可以查看 /hugegraph-server/logs/hugegraph-server.log 获取详细信息。

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}    

[shell-nlp]

你遇到的启动失败，是因为设置了 PASSWORD（开启鉴权模式）和 PRELOAD（预加载样例图）后，HugeGraph 会走认证和样例数据初始化的代码路径，这些路径需要访问 JDK 的内部 API（如 jdk.internal.reflect.Reflection.registerMethodsToFilter），但 Java 11+ 默认禁止访问这些内部模块，导致 InaccessibleObjectException 抛错，容器无法正常启动。相关源码分析

解决方法：在 Docker Compose 的环境变量里加上 JVM 参数，允许访问 JDK 内部 API。具体做法如下：

version: '3'
services:
server:
image: docker.1ms.run/hugegraph/hugegraph:latest
container_name: server
environment:
- PASSWORD=hugegraph@2025
- PRELOAD=true
- JAVA_OPTS=--add-exports=java.base/jdk.internal.reflect=ALL-UNNAMED
ports:
- 58080:8080
这样 HugeGraph 启动时就能访问需要的 JDK 内部 API，避免报错。如果你用的是生产环境，建议用官方 release tag 镜像（如 hugegraph/hugegraph:1.5.0），不要用 latest，以保证稳定性。

如果还有其他报错，可以查看 /hugegraph-server/logs/hugegraph-server.log 获取详细信息。

To reply, just mention @dosu.

How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other    
无法解决这个问题

[Tsukilc]

Thx. We’ve fixed this issue in #2905

[Tsukilc]

You can try pulling the latest image again