fix(sdk): handle graphql errors properly

Author: wangshijun

packages/sdk-util/src/index.js

@@ -284,20 +284,42 @@ class BaseClient {
       ),
     });
 
-    if (res.status === 200) {
-      const json = await res.json();
-      debug('_doRequest.response', { status: res.status, errors: json.errors });
-
-      if (Array.isArray(json.errors) && json.errors.length) {
-        const err = new Error(`GraphQLError: ${json.errors.map(x => x.message).join('; ')}`);
-        err.errors = json.errors;
-        throw err;
+    let json;
+    try {
+      json = await res.json();
+      debug('_doRequest.response', { status: res.status, errors: json ? json.errors : undefined });
+    } catch (err) {
+      json = {};
+    }
+
+    // Handle GraphQL errors regardless of HTTP status
+    if (Array.isArray(json.errors) && json.errors.length) {
+      const errorMessages = json.errors.map(x => x.message);
+      const hasSchemaError = errorMessages.some(msg => msg.includes('Cannot query field'));
+
+      let message = errorMessages.join('\n');
+      if (hasSchemaError) {
+        message = `Schema Compatibility Error: ${message}\nThis error typically indicates you are using an incompatible GraphQL client version. Please ensure your client version matches the server schema version.`;
+      } else {
+        message = `GraphQLError: ${message}`;
       }
 
-      return dataKey && json.data[dataKey] ? json.data[dataKey] : json.data;
+      const err = new Error(message);
+      err.errors = json.errors;
+      err.status = res.status;
+      throw err;
+    }
+
+    // Handle HTTP errors
+    if (res.status !== 200) {
+      const message = json.error || json.message || `GraphQL Status Error ${res.status}`;
+      const err = new Error(message);
+      err.status = res.status;
+      err.response = json;
+      throw err;
     }
 
-    throw new Error(`GraphQL Status Error ${res.status}`);
+    return dataKey && json.data[dataKey] ? json.data[dataKey] : json.data;
   }
 
   /**
@@ -491,4 +513,3 @@ class BaseClient {
 }
 
 module.exports = BaseClient;
-//# sourceMappingURL=index.js.map