infiniflow/ragflow · error · ConnectorMissingCredentialError

Gitlab

Error message

Gitlab

What it means

Error "Gitlab" thrown in infiniflow/ragflow.

Source

Thrown at common/data_source/gitlab_connector.py:208

                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()
                files = project.repository_tree(path=current_path, all=True)
                for file_batch in _batch_gitlab_objects(files, self.batch_size):
                    code_doc_batch: list[Document] = []
                    for file in file_batch:
                        if _should_exclude(file["path"]):
                            continue

View on GitHub (pinned to 554fb1133a)

Solutions

1. Review the connector credential payload; required GitLab fields must be present.
2. Check connector logs for the specific validation failure.

Example fix

credentials = {'gitlab_token': '<token>', 'project': 'group/project'}

When it happens

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

Common situations: A generic GitLab connector failure occurs, typically from incomplete credentials or an unreachable instance; completing the configuration prevents this error.

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