Add logging for SSR render request failures (#63) (#89)

When server-side rendering fails (e.g., SSR server unavailable or returns
an error), Inertia silently falls back to client-side rendering. This made
debugging SSR issues difficult since errors were swallowed without any trace.

This change uses Python's logging module to log exceptions when SSR requests
fail, providing visibility into SSR failures while maintaining the graceful
fallback behavior.

Fixes #63

Co-authored-by: leeuwr <[email protected]>

Author: leeuwr

inertia/http.py

@@ -1,3 +1,4 @@
+import logging
 from functools import wraps
 from http import HTTPStatus
 from json import dumps as json_encode
@@ -18,6 +19,7 @@
 except ImportError:
     requests = None  # type: ignore[assignment]
 
+logger = logging.getLogger(__name__)
 
 INERTIA_REQUEST_ENCRYPT_HISTORY = "_inertia_encrypt_history"
 INERTIA_SESSION_CLEAR_HISTORY = "_inertia_clear_history"
@@ -172,7 +174,7 @@ def build_first_load_context_and_template(
                     **self.template_data,
                 }, INERTIA_SSR_TEMPLATE
             except Exception:
-                pass
+                logger.exception("SSR render request failed")
 
         return {
             "page": data,

inertia/tests/test_ssr.py

@@ -65,7 +65,7 @@ def test_it_uses_inertia_if_inertia_requests_are_made(self, mock_requests):
     @patch("inertia.http.requests")
     def test_it_fallsback_on_failure(self, mock_requests):
         def uh_oh(*args, **kwargs):
-            raise ValueError()  # all exceptions are caught and ignored
+            raise ValueError()  # SSR errors are logged and fall back to client-side rendering
 
         mock_response = Mock()
         mock_response.raise_for_status.side_effect = uh_oh
@@ -75,3 +75,16 @@ def uh_oh(*args, **kwargs):
         self.assertContains(
             response, inertia_div("props", props={"name": "Brandon", "sport": "Hockey"})
         )
+
+    @patch("inertia.http.logger")
+    @patch("inertia.http.requests")
+    def test_it_logs_exception_on_ssr_failure(self, mock_requests, mock_logger):
+        error = ValueError("SSR rendering failed")
+
+        mock_response = Mock()
+        mock_response.raise_for_status.side_effect = error
+        mock_requests.post.return_value = mock_response
+
+        self.client.get("/props/")
+
+        mock_logger.exception.assert_called_once_with("SSR render request failed")