fix: NullReferenceException and JsonReaderException in Taxonomy model; improve error handling and messaging.

Author: nadeem-cs

CHANGELOG.md

@@ -1,3 +1,15 @@
+### Version: 2.25.2
+#### Date: Nov-13-2025
+
+##### Fix: 
+- Taxonomy
+  - Fixed NullReferenceException in `_Url` property when Stack is null
+  - Fixed NullReferenceException in constructor when ContentstackClient parameter is null
+  - Fixed InvalidCastException in `GetContentstackError` when exception is not a WebException
+  - Fixed NullReferenceException in `GetContentstackError` when WebException.Response is null
+  - Fixed JsonReaderException in `GetContentstackError` when response is not valid JSON
+  - All exceptions now properly throw TaxonomyException (extends ContentstackException) with descriptive error messages
+
 ### Version: 2.25.1
 #### Date: Nov-10-2025
 

Contentstack.Core/Models/Taxonomy.cs

@@ -21,6 +21,14 @@ protected override string _Url
         {
             get
             {
+                if (this.Stack == null)
+                {
+                    throw new TaxonomyException("Taxonomy Stack instance is null. Please ensure the Taxonomy is properly initialized with a ContentstackClient instance.");
+                }
+                if (this.Stack.Config == null)
+                {
+                    throw new TaxonomyException("Taxonomy Stack Config is null. Please ensure the ContentstackClient is properly configured.");
+                }
                 Config config = this.Stack.Config;
                 return String.Format("{0}/taxonomies/entries", config.BaseUrl);
             }
@@ -40,6 +48,10 @@ internal Taxonomy()
         }
         internal Taxonomy(ContentstackClient stack): base(stack)
         {
+            if (stack == null)
+            {
+                throw new TaxonomyException("ContentstackClient instance cannot be null when creating a Taxonomy instance.");
+            }
             this.Stack = stack;
             this._StackHeaders = stack._LocalHeaders;
         }
@@ -252,30 +264,59 @@ internal static ContentstackException GetContentstackError(Exception ex)
 
             try
             {
-                System.Net.WebException webEx = (System.Net.WebException)ex;
-
-                using (var exResp = webEx.Response)
-                using (var stream = exResp.GetResponseStream())
-                using (var reader = new StreamReader(stream))
+                System.Net.WebException webEx = ex as System.Net.WebException;
+                
+                if (webEx != null && webEx.Response != null)
                 {
-                    errorMessage = reader.ReadToEnd();
-                    JObject data = JObject.Parse(errorMessage.Replace("\r\n", ""));
+                    using (var exResp = webEx.Response)
+                    {
+                        var stream = exResp.GetResponseStream();
+                        if (stream != null)
+                        {
+                            using (stream)
+                            using (var reader = new StreamReader(stream))
+                            {
+                                errorMessage = reader.ReadToEnd();
+                                
+                                if (!string.IsNullOrWhiteSpace(errorMessage))
+                                {
+                                    try
+                                    {
+                                        JObject data = JObject.Parse(errorMessage.Replace("\r\n", ""));
 
-                    JToken token = data["error_code"];
-                    if (token != null)
-                        errorCode = token.Value<int>();
+                                        JToken token = data["error_code"];
+                                        if (token != null)
+                                            errorCode = token.Value<int>();
 
-                    token = data["error_message"];
-                    if (token != null)
-                        errorMessage = token.Value<string>();
+                                        token = data["error_message"];
+                                        if (token != null)
+                                            errorMessage = token.Value<string>();
 
-                    token = data["errors"];
-                    if (token != null)
-                        errors = token.ToObject<Dictionary<string, object>>();
+                                        token = data["errors"];
+                                        if (token != null)
+                                            errors = token.ToObject<Dictionary<string, object>>();
+                                    }
+                                    catch (Newtonsoft.Json.JsonException)
+                                    {
+                                        // If JSON parsing fails, use the raw error message
+                                        // errorMessage is already set from ReadToEnd()
+                                    }
+                                }
 
-                    var response = exResp as HttpWebResponse;
-                    if (response != null)
-                        statusCode = response.StatusCode;
+                                var response = exResp as HttpWebResponse;
+                                if (response != null)
+                                    statusCode = response.StatusCode;
+                            }
+                        }
+                        else
+                        {
+                            errorMessage = webEx.Message;
+                        }
+                    }
+                }
+                else
+                {
+                    errorMessage = ex.Message;
                 }
             }
             catch

Directory.Build.props

@@ -1,5 +1,5 @@
 <Project>
   <PropertyGroup>
-    <Version>2.25.1</Version>
+    <Version>2.25.2</Version>
   </PropertyGroup>
 </Project>