[Bug] backup error of 1.5.0 version

[hexuxu110]

Bug Type (问题类型)

None

Before submit

• I had searched in the issues and found no similar issues.

Environment (环境信息)

• Server Version: v1.5.0
• Toolchain Version: v1.5.0
• Data Size: xx vertices, xx edges

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

server version:1.5.0
client version:1.5.0

when using backup, you can get the error that is "Failed to execute Unrecognized field "edgelabel_type" (class org.apache.hugegraph.structure.schema.EdgeLabel), not marked as ignorable (15 known properties: "check_exist", "target_label", "name", "index_labels", "source_label", "status", "properties", "sort_keys", "id", "frequency", "ttl_start_time", "user_data", "enable_label_index", "ttl", "nullable_keys"])"

The sentence of backup is
"${HUGEGRAPH_TOOL_BIN}" --url "${GRAPH_URL}" --graph "${GRAPH_NAME}"
backup -t "vertex,vertex_label,edge_label,property_key,index_label" --compress false
--directory "${LOCAL_BACKUP_DIR}" -l "${LOG_FILE}"
"

who can help me!!!

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

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

[dosubot]

This error happens because the backup or loader tool is trying to deserialize a schema that includes the edgelabel_type field, but the receiving class doesn't recognize it. This usually means there's a version mismatch between your HugeGraph server and the toolchain components—even if both say "v1.5.0", sometimes the Docker images or binaries are not perfectly aligned, or one was updated and the other wasn't. The edgelabel_type field was introduced with new edge label types like "NORMAL", "PARENT", and "SUB" and is now expected in the schema JSON for edge labels in recent versions.

To fix this, make sure your server and all toolchain components (backup, loader, client) are using exactly the same version and build. If you're using Docker, double-check your docker-compose.yml or image tags to ensure both are set to the same version and not mixing "latest" with "1.5.0". This has resolved the issue for other users in similar situations reference.

If you still see the error, check your backup files for the edgelabel_type field. If your toolchain doesn't recognize it, you may need to manually remove it from the JSON before restoring, or update your toolchain to a version that supports it.

Let me know if you need help checking your versions or editing your backup files!

To reply, just mention @dosu.

---

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

[imbajin]

refer: #689