infiniflow/ragflow · error · Exception

Unexpected error during GitHub settings validation: {exc}

Error message

Unexpected error during GitHub settings validation: {exc}

What it means

A bare Exception (not a connector error class) raised when anything other than RateLimitExceededException/GithubException escapes the try body of validate_connector_settings(). It re-wraps the original message with 'Unexpected error during GitHub settings validation:' but discards the traceback chain (no 'from exc').

Source

Thrown at common/data_source/github/connector.py:757

        except GithubException as e:
            if e.status == 401:
                raise CredentialExpiredError("GitHub credential appears to be invalid or expired (HTTP 401).")
            elif e.status == 403:
                raise InsufficientPermissionsError("Your GitHub token does not have sufficient permissions for this repository (HTTP 403).")
            elif e.status == 404:
                if self.repositories:
                    if "," in self.repositories:
                        raise ConnectorValidationError(f"None of the specified GitHub repositories could be found for owner: {self.repo_owner}")
                    else:
                        raise ConnectorValidationError(f"GitHub repository not found with name: {self.repo_owner}/{self.repositories}")
                else:
                    raise ConnectorValidationError(f"GitHub user or organization not found: {self.repo_owner}")
            else:
                raise ConnectorValidationError(f"Unexpected GitHub error (status={e.status}): {e.data}")

        except Exception as exc:
            raise Exception(f"Unexpected error during GitHub settings validation: {exc}")

    def validate_checkpoint_json(self, checkpoint_json: str) -> GithubConnectorCheckpoint:
        return GithubConnectorCheckpoint.model_validate_json(checkpoint_json)

    def retrieve_slim_document(
        self,
        start: SecondsSinceUnixEpoch | None = None,
        end: SecondsSinceUnixEpoch | None = None,
        callback: Any = None,
    ) -> GenerateSlimDocumentOutput:
        start_value = 0.0 if start is None else start
        end_value = datetime.now(timezone.utc).timestamp() if end is None else end
        checkpoint = self.build_dummy_checkpoint()
        slim_batch: list[SlimDocument] = []

        while checkpoint.has_more:
            wrapper = CheckpointOutputWrapper[GithubConnectorCheckpoint]()
            for document, failure, next_checkpoint in wrapper(self.load_from_checkpoint(start_value, end_value, checkpoint)):

View on GitHub (pinned to 554fb1133a)

Solutions

Inspect the wrapped message (or add 'from exc' locally) to identify the underlying exception, then fix that root cause.
Verify network egress to api.github.com (proxy/firewall) from the service running validation.
Pin/upgrade PyGithub to a version compatible with the installed requests version.

Example fix

// before
        except Exception as exc:
            raise Exception(f"Unexpected error during GitHub settings validation: {exc}")

// after
        except Exception as exc:
            raise UnexpectedValidationError(
                f"Unexpected error during GitHub settings validation: {exc}"
            ) from exc

Defensive patterns

Strategy: try-catch

Try / catch

try:
    connector.validate_connector_settings()
except Exception as e:  # this path raises bare Exception
    log_full_traceback(e)
    diagnose_network_or_dependency(e)

Prevention

Pin PyGithub and requests to tested versions; upgrade them together.
Verify proxy/TLS egress to api.github.com from the validating service.
Patch the raise to use 'from exc' so future occurrences keep their traceback.

When it happens

Trigger: Non-GitHub exceptions inside the probe: AttributeError from an unexpected PyGithub response shape, network-layer errors (requests exceptions) not wrapped as GithubException, or bugs like a None response attribute.

Common situations: PyGithub/network version mismatches; proxies or TLS interception raising requests exceptions; intermittent DNS failures during validation.

Related errors

AI-assisted analysis of infiniflow/ragflow@554fb1133a (2026-08-15). Data as JSON: /api/errors/e717eeb34e6cff71. Report an issue: GitHub.