Literaturverweise erscheinen nur als fette Marken der Art **`[citekey]`**, das Literaturverzeichnis fehlt oder ist unvollständig
----
Dieses Problem kann verschiedene Ursachen haben. Allen gemeinsam ist, dass `biber` nicht erfolgreich aufgerufen wurde oder nicht genügend LaTeX-Läufe nach dem `biber`-Aufruf erfolgten. Dass `biber` nicht aufgerufen wurde, kann man auch daran erkennen, dass keine (aktuelle) `*.blg`-Datei existiert. Generell ist zu beachten, dass für korrekte Literaturverweise und ein vollständiges Literaturverzeichnis folgende Bedingungen zu beachten sind:
* **Alle im Literaturverzeichnis aufzuführenden Quellen müssen zitiert werden** (beispielsweise per `\cite`, `\autocite`, `\footcite`, `\parencite` …) oder per `\nocite` als nicht zitiert aber aufzunehmen markiert sein.
* **Es muss auch wirklich `biber` aufgerufen werden** und nicht etwa `bibtex` oder `bibtex8` (Ausnahme ist, wenn per `biblatex`-Option – beispielsweise `backend=bibtex` oder `backend=bibtex8` – explizit eine Legacy-Backend ausgewählt wurde, was normalerweise nicht zu empfehlen ist). Den fälschlichen Aufruf von `bibtex` kann man sehr leicht daran erkennen, dass die Terminalausgabe des Aufrufs bzw. die `*.blg` mit »`This is BibTeX`« beginnt.
Zum Aufruf von `biber` aus dem Editor siehe: [Wie verwende ich biber in meinem Editor?](https://texwelt.de/fragen/1909)
* Es muss zunächst ein LaTeX-Lauf stattfinden (dabei wird eine `*.bcf`-Datei erzeugt). Dann muss `biber` aufgerufen werden (dabei wird die `*.bbl`-Datei erzeugt). Anschließend werden *zwei* weitere LaTeX-Läufe benötigt.
Kurz gefasst lauter der **Komplettzyklus** also: **LaTeX, biber, LaTeX, LaTeX**.
Zum Aufruf von `biber` aus dem Editor siehe: [Wie verwende ich biber in meinem Editor?](https://texwelt.de/fragen/1909)
Es ist zu beachten, dass dieser Komplettzyklus auch dann durchzuführen ist, wenn neue Quellen hinzugefügt bzw. zitiert werden oder der Zitierstil oder der Verzeichnisstil geändert wird.
Nicht alle Literaturverweise sind korrekt oder nicht alle Quellen im Literaturverzeichnis zu finden.
----
Das ist letztlich dasselbe Probem wie das vorherige. Die häufigsten Ursachen sind:
* Es wurde nicht der Komplettzyklus *LaTeX, biber, LaTeX, LaTeX* durchgeführt (siehe oben).
* Entweder beim LaTeX-Lauf oder beim biber-Lauf kam es zu einem Fehler, so dass der neue Eintrag nicht verarbeitet werden kann. Konsultiere dazu die `*.log`-Datei und die `*.blg`-Datei.
* Ein Eintrag in die Literaturdatenbank wurde gar nicht zitiert bzw. als im Literaturverzeichnis anzuzeigen markiert (siehe oben).
Siehe dazu auch das vorherige Problem.
`biblatex` meldet einen Fehler der Art: »`Package biblatex Error: File 'FOO.bbl' not created by biblatex`«.
----
Der Fehler tritt auch, auf, wenn beim LaTeX-Lauf eine `*.bbl`-Datei, die nicht mit `biblatex` und `biber` erstellt wurde, existiert. Dieser Fehler tritt häufig auf, wenn man von der Verwendung von BibTeX mit `\bibliographystyle` und `\bibliography` auf die Verwendung von `biblatex` und `biber` umstellt, ohne die `*.bbl`-Datei vor dem ersten LaTeX-Lauf nach der Umstellung zu löschen.
Prinzipiell kann man diese Fehlermeldung beim ersten LaTeX-Lauf ignorieren. Nach dem Aufruf von `biber` sollte er bei den notwendigen zwei weiteren LaTeX-Läufen nicht mehr auftreten. Besser ist jedoch, die **`*.bbl`-Datei** (und ruhig auch die alte `*.blg`-Datei, aber bitte *keinesfalls* die `*.bib`-Datei!) direkt nach der Umstellung zu **löschen** und einen neuen **Komplettzyklus**, also **LaTeX**, **biber**, **LaTeX**, **LaTeX**, durchzuführen.
`biber` meldet (in der `*.blg`-Datei) einen Fehler der Art: »`ERROR - Error: Found biblatex control file version …, expected version …`« zu finden.
----
Diese Fehlermeldung gibt es immer dann, wenn `biber` und `biblatex` in inkompatiblen Versionen installiert sind. Bei MiKTeX tritt dieses Problem beispielsweise dann auf, wenn bei einer Multi-User-Installation `biber` vom Admin installiert wurde, `biblatex` aber on-the-fly nicht für alle Benutzer, sondern nur für den aktuellen Benutzer nachinstalliert wurde. Es tritt außerdem bei unvollständigen Updates der TeX-Distribution auf, in der Regel, wenn nur `biblatex` aber nicht `biber` aktualisiert wird. Zu lösen ist es, durch ein **vollständiges Update** der TeX-Distribution. Bei Multi-User-Installationen von MiKTeX ist dazu ein Update sowohl im Admin-Modus als auch im User-Modus durchzuführen. Siehe dazu: [Wie kann ich MiKTeX updaten, dass wirklich alle Pakete auf dem neusten Stand sind?](https://texwelt.de/fragen/24357)
Der Fehler kann auch auftreten, wenn zwischen dem letzten Aufruf von `biblatex` und dem nächsten Aufruf von `biber` ein Update stattgefunden hat. In diesem Fall genügt es normalerweise, einen weiteren LaTeX-Lauf vor dem `biber`-Aufruf durchzuführen. Man kann aber auch einfach die `*.bcf`-Datei und die `*.bbl`-Datei zu löschen (aber *keinesfalls* die `*.bib`-Datei!) und dann einen neuen **Komplettzyklus** (LaTeX, biber, LaTeX, LaTeX) durchführen.
Siehe auch: [Found biblatex control file version …, expected version …](https://texwelt.de/fragen/17793)
`biber` meldet (in der `*.blg`-Datei) ein Problem der Art: »`Invalid format '01.08.2018' of date field 'date'`«
----
Diese Meldung bedeutet, dass das Datumsfeld `date` in einem Eintrag nicht das korrekte Format hat. Es tritt nicht nur mit Datumsangaben wie der genannten auf, sondern auch, wenn im Datumsformat etwas wie »`August 2018`« oder ähnliches eingetragen wurde. Auch eine einzelne Jahreszahl sollte besser als `year` und nicht als `date` eingetragen werden. `biber` hat strenge Regeln, was den Aufbau des Datums anbelangt.
Siehe auch: [Datum im Literaturverzeichnis](https://texwelt.de/fragen/22495).
Bei Nutzern von Literaturverwaltungen wie Citavis, JabRef kann die falsche Formatierung des Datums auch ein Hinweis darauf sein, dass sie die falschen Exporteinstellungen für die `*.bib`-Datei verwenden. Es ist bei Verwendung von `biblatex` mit `biber` generell darauf zu achten, dass eine `*.bib`-Datei für `biblatex` und nicht für `bibtex` erzeugt wird. Es sei an dieser Stelle auch empfohlen, UTF8 als Kodierung für den Export zu verwenden.
`biber` meldet (in der `*.blg`-Datei) etwas wie: »`year field … is not an integer`"
----
Dieses Problem ist dem vorherigen vergleichbar. Als Jahresangabe sind generell nur Zahlen erlaubt. Trägt man als `year` etwas wie `11. September 2001` oder `01.04.1967` ein, so kann `biber` das nicht als Jahresangabe erkennen. Vollständige Datumsangaben können (im ISO-Format) als `date` angegeben werden. Monat und Jahr können einzeln als `year` und `month` angegeben werden.
Siehe auch: [biber: year = {28. September 2012} resultiert in Warnung "year field … is not an integer"](https://texwelt.de/fragen/20222)
Ich finde die `*.blg`-Datei nicht.
----------------------------------
Dies kann zwei Ursachen haben. Möglicherweise wurde `biber` nicht aufgerufen. Um dieses Problem auszuschließen sollte man [den `biber`-Aufruf explizit erneut durchführen](https://texwelt.de/fragen/1909). Findet sich danach trotzdem keine (aktuelle) `*.blg`-Datei so liegt das bei Windows-Anwendern häufig daran, dass Windows in der Voreinstellung *bekannte Dateiendungen* ausblendet. Stattdessen wird in einer eigenen Spalte der Typ der Datei angezeigt. Windows bezeichnet `*.blg`-Dateien in der Regel als Datei vom Typ *Leistungsüberwachung*. Um solche und andere Probleme zu vermeiden, wird empfohlen [Dateiendungen unter Windows immer anzeigen zu lassen](https://www.heise.de/tipps-tricks/Windows-Dateiendungen-anzeigen-lassen-4000129.html).
Übrigens sind `*.blg`-Dateien von `biber` genau wie `*.log`-Dateien von TeX reine Textdateien. Sie können mit jedem Editor, auch einem LaTeX-Editor, über das `Datei`-Menü des Editors geöffnet werden. Durch einen Doppelklick im Windows-Explorer können sie hingegen in der Regel nicht geöffnet werden. Eventuell versucht das Windows-Explorer eine `*.blg`-Datei bei einem Doppelklick sogar mit einem Programm zur Auswertung von Leistungsüberwachungsdateien zu öffnen, falls ein solches installiert sein sollte.
Ich habe all das beachtet, aber `biber` startet nicht oder meldet weiterhin *seltsame* Fehler
---------------------------------------------------------------------------------------------
Biber ist ein selbstentpackendes perl-Script. Das heißt, beim ersten Start (nach einem Update) entpackt es sich zuerst selbst in ein Cache-Verzeichnis. Alle weiteren Starts rufen das einmal entpackte perl-Script auf. Manchmal kommt es jedoch vor, dass das Cache-Verzeichnis bzw. dessen Inhalt beschädigt wird. Die Ursache dafür sind vielfältig, beispielsweise ein Abbruch während des Entpackens, irgendwelche Aufräumarbeiten des OS oder irgendwelche über das Ziel hinaus schießende Virenscanner.
Wenn man Glück hat, funktioniert `biber` noch so weit, dass es selbst das Cache-Verzeichnis anzeigen kann. Dazu öffnet man eine Console, ein Terminal bzw. die Eingabeaufforderung und gibt dort
biber --cache
ein. Das Programm gibt dann im Idealfall ein Verzeichnis aus, das eine Zeichenfolge enthält, die wie folgt aufgebaut ist: `…/par-<HEXCODE>/cache-<CHECKSUM>`. Der `<HEXCODE>` ist übrigens die hexadezimale Darstellung des Benutzernames. Sollte `biber` nicht in der Lage sein, das Verzeichnis auszugeben, weil der Start bereits davor (meist mit einer Fehlermeldung) abbricht, so kann man das Verzeichnis über die Dateisuche des Betriebssystems finden. Näheres zu möglichen Orten ist [in der Erklärung von Alan Munn auf TeX.SX](https://tex.stackexchange.com/a/140815) zu finden.
Nun löscht man das Verzeichnis `cache-<CHECKSUM>`. Beim nächsten Start von `biber` wird der Cache neu aufgebaut. Das dauert einige Zeit – in der Regel eigentlich nur Sekunden, aber manchmal kommt es einem wie eine Ewigkeit vor – und man sollte den Vorgang keinesfalls abbrechen und `biber` ein weiteres Mal starten. Anderenfalls ist die Wahrscheinlichkeit hoch, dass das Problem erneut auftritt.
Sollte das Problem trotzdem bestehen bleiben, stellt man eine Frage einschließlich [vollständigem Minimalbeispiel](http://texwelt.de/wissen/fragen/569/), `*.blg`-Datei, Fehlermeldungen aus der `*.log`-Datei und einer genauen Beschreibung, wie man LaTeX und Biber aufgerufen hat.