infiniflow/ragflow · error · ConnectorValidationError

GitLab project not found or not accessible.

Error message

GitLab project not found or not accessible.

What it means

Error "GitLab project not found or not accessible." thrown in infiniflow/ragflow.

Source

Thrown at common/data_source/gitlab_connector.py:201

    def validate_connector_settings(self) -> None:
        if self.gitlab_client is None:
            raise ConnectorMissingCredentialError("GitLab")

        try:
            self.gitlab_client.auth()
            self.gitlab_client.projects.get(
                f"{self.project_owner}/{self.project_name}",
                lazy=True,
            )

        except gitlab.exceptions.GitlabAuthenticationError as e:
            raise CredentialExpiredError("Invalid or expired GitLab credentials.") from e

        except gitlab.exceptions.GitlabAuthorizationError as e:
            raise InsufficientPermissionsError("Insufficient permissions to access GitLab resources.") from e

        except gitlab.exceptions.GitlabGetError as e:
            raise ConnectorValidationError("GitLab project not found or not accessible.") from e

        except Exception as e:
            raise UnexpectedValidationError(f"Unexpected error while validating GitLab settings: {e}") from e

    def _fetch_from_gitlab(self, start: datetime | None = None, end: datetime | None = None) -> GenerateDocumentsOutput:
        if self.gitlab_client is None:
            raise ConnectorMissingCredentialError("Gitlab")
        project: Project = self.gitlab_client.projects.get(f"{self.project_owner}/{self.project_name}")

        start_utc = start.astimezone(timezone.utc) if start else None
        end_utc = end.astimezone(timezone.utc) if end else None

        # Fetch code files
        if self.include_code_files:
            # Fetching using BFS as project.report_tree with recursion causing slow load
            queue = deque([""])  # Start with the root directory
            while queue:
                current_path = queue.popleft()

View on GitHub (pinned to 554fb1133a)

Solutions

1. Verify the project path/ID in the connector settings.
2. Ensure the token can access the project.

Example fix

# use the full path: group/subgroup/project

When it happens

Trigger: Thrown at common/data_source/gitlab_connector.py:201 when the library encounters an invalid state.

Common situations: The configured GitLab project does not exist, was renamed, or is private without access; correcting the project reference prevents this error.

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