▶ Se corrigió el error de Flatpak "No existe tal referencia en Flathub remoto" [SOLVED]

Tabla de Contenidos

Resumen de solución rápida

Si ve el error «Advertencia: trate los errores de recuperación remota como no fatales» o «No existe tal referencia en el flathub remoto» en tiempo de ejecución flatpak update o flatpak repairsu repositorio Flatpak nativo no está sincronizado. Reparación en 4 pasos:

Borrar archivos temporales: sudo rm -rf /var/lib/flatpak/repo/tmp/*
Eliminar referencias almacenadas en caché: sudo rm -rf /var/lib/flatpak/repo/refs/remotes/flathub
Ejecute la reparación del sistema: sudo flatpak repair --system
Limpiar paquetes no utilizados: flatpak update && flatpak uninstall --unused

Esta solución se aplica a todas las distribuciones de Linux, incluidas Arch Linux, Debian, Fedora, Linux Mint, Manjaro, Pop!_OS y Ubuntu.

¿Qué significa «No existe tal referencia en el Flathub remoto»?

mientras corres flatpak update Al ejecutar comandos en Linux, puede encontrar el siguiente mensaje de error:

[...]
F: Warning: Treating remote fetch error as non-fatal since runtime/app.devsuite.Ptyxis.Locale/x86_64/stable is already installed: No such ref 'runtime/app.devsuite.Ptyxis.Locale/x86_64/stable' in remote flathub
F: Warning: Treating remote fetch error as non-fatal since app/org.videolan.VLC/x86_64/stable is already installed: No such ref 'app/org.videolan.VLC/x86_64/stable' in remote flathub
F: Warning: Treating remote fetch error as non-fatal since app/org.upscayl.Upscayl/x86_64/stable is already installed: No such ref 'app/org.upscayl.Upscayl/x86_64/stable' in remote flathub
F: Warning: Treating remote fetch error as non-fatal since app/org.mozilla.firefox/x86_64/stable is already installed: No such ref 'app/org.mozilla.firefox/x86_64/stable' in remote flathub
F: Warning: Treating remote fetch error as non-fatal since app/org.localsend.localsend_app/x86_64/stable is already installed: No such ref 'app/org.localsend.localsend_app/x86_64/stable' in remote flathub
F: Warning: Treating remote fetch error as non-fatal since app/org.gimp.GIMP/x86_64/stable is already installed: No such ref 'app/org.gimp.GIMP/x86_64/stable' in remote flathub
F: Warning: Treating remote fetch error as non-fatal since app/net.trowell.typesetter/x86_64/stable is already installed: No such ref 'app/net.trowell.typesetter/x86_64/stable' in remote flathub
F: Warning: Treating remote fetch error as non-fatal since app/net.cozic.joplin_desktop/x86_64/stable is already installed: No such ref 'app/net.cozic.joplin_desktop/x86_64/stable' in remote flathub
F: Warning: Treating remote fetch error as non-fatal since app/md.obsidian.Obsidian/x86_64/stable is already installed: No such ref 'app/md.obsidian.Obsidian/x86_64/stable' in remote flathub
F: Warning: Treating remote fetch error as non-fatal since app/io.podman_desktop.PodmanDesktop/x86_64/stable is already installed: No such ref 'app/io.podman_desktop.PodmanDesktop/x86_64/stable' in remote flathub
F: Warning: Treating remote fetch error as non-fatal since app/io.github.flattool.Warehouse/x86_64/stable is already installed: No such ref 'app/io.github.flattool.Warehouse/x86_64/stable' in remote flathub
F: Warning: Treating remote fetch error as non-fatal since app/info.smplayer.SMPlayer/x86_64/stable is already installed: No such ref 'app/info.smplayer.SMPlayer/x86_64/stable' in remote flathub
F: Warning: Treating remote fetch error as non-fatal since app/fr.handbrake.ghb/x86_64/stable is already installed: No such ref 'app/fr.handbrake.ghb/x86_64/stable' in remote flathub
F: Warning: Treating remote fetch error as non-fatal since app/dev.geopjr.Archives/x86_64/stable is already installed: No such ref 'app/dev.geopjr.Archives/x86_64/stable' in remote flathub
F: Warning: Treating remote fetch error as non-fatal since app/com.xnview.XnSketch/x86_64/stable is already installed: No such ref 'app/com.xnview.XnSketch/x86_64/stable' in remote flathub
F: Warning: Treating remote fetch error as non-fatal since app/com.xnview.XnConvert/x86_64/stable is already installed: No such ref 'app/com.xnview.XnConvert/x86_64/stable' in remote flathub
F: Warning: Treating remote fetch error as non-fatal since app/com.github.tchx84.Flatseal/x86_64/stable is already installed: No such ref 'app/com.github.tchx84.Flatseal/x86_64/stable' in remote flathub
F: Warning: Treating remote fetch error as non-fatal since app/com.github.qarmin.czkawka/x86_64/stable is already installed: No such ref 'app/com.github.qarmin.czkawka/x86_64/stable' in remote flathub
F: Warning: Treating remote fetch error as non-fatal since app/be.alexandervanhee.gradia/x86_64/stable is already installed: No such ref 'app/be.alexandervanhee.gradia/x86_64/stable' in remote flathub
F: Warning: Treating remote fetch error as non-fatal since app/app.devsuite.Ptyxis/x86_64/stable is already installed: No such ref 'app/app.devsuite.Ptyxis/x86_64/stable' in remote flathub

No existe tal referencia en el error Flathub remoto

Este error significa que los metadatos de Flatpak local apuntan a una referencia (ref) que ya no existe en el repositorio remoto de Flathub. Las razones comunes incluyen:

La versión en tiempo de ejecución ha llegado al final de su vida útil (EOL)
Se eliminaron ramas obsoletas de Flathub
Proceso de actualización interrumpido
Los metadatos locales están dañados.

Hoy me encontré con este problema (advertencia «Tratar los errores de recuperación remota como no fatales») en un sistema Linux de escritorio Debian. No puedo descargar nuevos ni actualizar los existentes. Sigo recibiendo esta advertencia: «Trate los errores de recuperación remota como no fatales».

Albricias: Su solicitud aún es válida. Flatpak los marca como errores no fatales para preservar sus aplicaciones instaladas. Sin embargo, las discrepancias de metadatos impiden las actualizaciones correctas y deben solucionarse.

¿Por qué veo tantas advertencias?

No entre en pánico si ve docenas de advertencias de «no existen tales referencias» para paquetes de software como Firefox, VLC, GIMP o LibreOffice. Estas aplicaciones comparten un tiempo de ejecución de plataforma común:

org.freedesktop.Platform
org.gnome.Platform
org.kde.Platform

Cuando una única rama de tiempo de ejecución queda obsoleta, cada aplicación que la utilice generará una advertencia. Un tiempo de ejecución obsoleto = múltiples advertencias. Las cifras son alarmantes, pero suelen indicar un problema subyacente.

Cómo solucionar el error «No existe tal referencia» de Flatpak (4 pasos)

Importante: Estos comandos son seguros y no desinstalarán su aplicación. Siga los pasos en orden.

Paso 1: borre los archivos de la biblioteca provisional

Primero, elimine cualquier descarga obsoleta o incompleta del directorio temporal:

sudo rm -rf /var/lib/flatpak/repo/tmp/*

Esto eliminará las descargas parciales que pueden causar conflictos con la sincronización de metadatos.

Paso 2: eliminar las referencias remotas almacenadas en caché

Elimine la referencia remota Flathub almacenada en caché para forzar una reconstrucción completa:

sudo rm -rf /var/lib/flatpak/repo/refs/remotes/flathub

Esto obliga a Flatpak a volver a descargar los metadatos actuales de Flathub, eliminando así las referencias a la rama obsoleta.

advertencia de seguridad seria

Nunca elimine estos directorios:

/var/lib/flatpak
~/.local/share/flatpak

Al eliminar estos directorios, se eliminarán todas las aplicaciones y datos de Flatpak instalados. Elimine solo las rutas específicas mencionadas en los pasos 1 y 2.

Paso 3: ejecute la reparación del sistema Flatpak

Utilice privilegios de root para ejecutar las instrucciones de reparación:

sudo flatpak repair --system

Por qué se necesita sudo: No sudoFlatpak solo realiza un ensayo y muestra «assume –dry-run» sin realizar cambios. Usando privilegios de root, el comando de reparación:

Verificar sumas de verificación de todos los objetos instalados
Reconstruir metadatos de referencia internos
Eliminar referencias huérfanas e inválidas
Sincronizar el estado local con el estado remoto actual

Deje que el proceso de reparación se complete sin interrupciones. Esto puede tardar unos minutos dependiendo de la cantidad de aplicaciones instaladas.

Salida de ejemplo:

Working on the system installation at /var/lib/flatpak
Checking remotes...
Pruning objects
Erasing .removed
Reinstalling removed refs
Installing runtime/app.devsuite.Ptyxis.Locale/x86_64/stable
Installing app/app.devsuite.Ptyxis/x86_64/stable
Installing runtime/be.alexandervanhee.gradia.Locale/x86_64/stable
Installing app/be.alexandervanhee.gradia/x86_64/stable
Installing app/com.github.qarmin.czkawka/x86_64/stable
Installing app/com.github.tchx84.Flatseal/x86_64/stable
Installing runtime/com.xnview.XnConvert.Locale/x86_64/stable
Installing app/com.xnview.XnConvert/x86_64/stable
Installing runtime/com.xnview.XnSketch.Locale/x86_64/stable
Installing app/com.xnview.XnSketch/x86_64/stable
Installing runtime/dev.geopjr.Archives.Locale/x86_64/stable
Installing app/dev.geopjr.Archives/x86_64/stable
Installing runtime/fr.handbrake.ghb.Locale/x86_64/stable
Installing app/fr.handbrake.ghb/x86_64/stable
Installing app/info.smplayer.SMPlayer/x86_64/stable
Installing runtime/io.github.flattool.Warehouse.Locale/x86_64/stable
Installing app/io.github.flattool.Warehouse/x86_64/stable
Installing app/io.podman_desktop.PodmanDesktop/x86_64/stable
Installing runtime/md.obsidian.Obsidian.Locale/x86_64/stable
Installing app/md.obsidian.Obsidian/x86_64/stable
Installing app/net.cozic.joplin_desktop/x86_64/stable
Installing runtime/net.trowell.typesetter.Locale/x86_64/stable
Installing app/net.trowell.typesetter/x86_64/stable
Installing runtime/org.freedesktop.Platform.GL.default/x86_64/24.08
Installing runtime/org.freedesktop.Platform.GL.default/x86_64/24.08extra
Installing runtime/org.freedesktop.Platform.GL.default/x86_64/25.08
Installing runtime/org.freedesktop.Platform.GL.default/x86_64/25.08-extra
Installing runtime/org.freedesktop.Platform.Locale/x86_64/24.08
Installing runtime/org.freedesktop.Platform.Locale/x86_64/25.08
Installing runtime/org.freedesktop.Platform.VAAPI.Intel/x86_64/24.08
Installing runtime/org.freedesktop.Platform.VAAPI.Intel/x86_64/25.08
Installing runtime/org.freedesktop.Platform.codecs-extra/x86_64/25.08-extra
Installing runtime/org.freedesktop.Platform.ffmpeg-full/x86_64/24.08
Installing runtime/org.freedesktop.Platform.openh264/x86_64/2.5.1
Installing runtime/org.freedesktop.Platform/x86_64/24.08
Installing runtime/org.freedesktop.Platform/x86_64/25.08
Installing app/org.gimp.GIMP/x86_64/stable
Installing runtime/org.gnome.Platform.Locale/x86_64/48
Installing runtime/org.gnome.Platform.Locale/x86_64/49
Installing runtime/org.gnome.Platform/x86_64/48
Installing runtime/org.gnome.Platform/x86_64/49
Installing runtime/org.kde.KStyle.Adwaita/x86_64/5.15-24.08
Installing runtime/org.kde.Platform.Locale/x86_64/5.15-24.08
Installing runtime/org.kde.Platform/x86_64/5.15-24.08
Installing app/org.localsend.localsend_app/x86_64/stable
Installing runtime/org.mozilla.firefox.Locale/x86_64/stable
Installing app/org.mozilla.firefox/x86_64/stable
Installing app/org.upscayl.Upscayl/x86_64/stable
Installing runtime/org.videolan.VLC.Locale/x86_64/stable
Installing app/org.videolan.VLC/x86_64/stable

Note that '/var/lib/flatpak/exports/share' is not in the search path
set by the XDG_DATA_HOME and XDG_DATA_DIRS
environment variables, so applications may not
be able to find it until you set them. The
directories currently searched are:

- /root/.local/share
- /usr/local/share/
- /usr/share/

Paso 4: actualice y elimine los paquetes no utilizados

Finalmente, actualice todas las aplicaciones y limpie el tiempo de ejecución obsoleto:

flatpak update
flatpak uninstall --unused

este flatpak uninstall --unused El comando elimina cualquier versión antigua del tiempo de ejecución que la aplicación instalada ya no necesite. Esto recupera espacio en disco y elimina las referencias obsoletas que causaron errores.

Cómo verificar que la solución funcionó

Después de completar todos los pasos, ejecute:

flatpak update

Métricas de éxito:

No aparecerá la advertencia «No existe tal referencia»
Mostrar «Nada que hacer» o mostrar las actualizaciones disponibles cuando se complete el comando
No aparece el mensaje «Tratar los errores de recuperación remota como no fatales»

También puedes verificar tu configuración remota:

flatpak remotes --show-details

confirmar flathub URL visible

Name    Title   URL                          Collection ID Subset Filter Priority Options … … Homepage             Icon
flathub Flathub  -             -      -      1        system  … …  logo.svg

Solución de problemas: si la solución no funciona

Problema: el error persiste después de solucionarlo

Solución: Es posible que el control remoto Flathub esté configurado incorrectamente. Eliminarlo y agregarlo nuevamente:

sudo flatpak remote-delete flathub
sudo flatpak remote-add --if-not-exists flathub flathub.flatpakrepo

Luego repita los pasos 3 y 4 en la reparación principal.

Problema: aparece el mensaje «Asumir –dry-run»

Solución: te olvidaste sudo. correr:

sudo flatpak repair --system

Flatpak no puede realizar cambios a nivel del sistema sin privilegios de root.

Problema: error de red o certificado SSL

Solución: Actualice las credenciales de CA del sistema:

# Debian / Ubuntu / Linux Mint / Pop_!OS
sudo apt update && sudo apt install ca-certificates

# Fedora / RHEL / AlmaLinux / Rocky Linux
sudo dnf update ca-certificates

# Arch Linux / Endeavour OS / Manjaro
sudo pacman -Sy ca-certificates

Luego intente nuevamente el proceso de reparación de Flatpak.

¿Por qué ocurre este error?

Usos de Flatpak árbol del sistema operativoun sistema de almacenamiento dirigido a contenido donde cada aplicación y tiempo de ejecución tiene una suma de verificación única. Las referencias (refs) apuntan a confirmaciones específicas en este sistema.

Escenarios comunes que conducen a discrepancias en las referencias:

Detener la producción durante la operación: Flathub desaprobará las versiones anteriores de tiempo de ejecución (por ejemplo, GNOME 43, KDE 5.15) cuando las nuevas versiones se estabilicen. Su sistema nativo todavía hace referencia a la versión anterior.
Actualización interrumpida: Las actualizaciones fallidas o canceladas pueden dejar metadatos locales que apunten a referencias parcialmente actualizadas.
Reorganización del repositorio: Ocasionalmente, los mantenedores de Flathub reorganizan ramas de paquetes o migran aplicaciones a diferentes repositorios.
Largos periodos de inactividad: Los sistemas que no se han actualizado en meses pueden tener metalocales desactualizados que hacen referencia a ramas obsoletas.

Esta solución funciona borrando los datos de caché obsoletos y obligando a Flatpak a reconstruir sus metadatos en función del estado remoto actual de Flathub.

Errores comunes que empeoran las cosas

Ignore las advertencias durante meses: Los más antiguos acumulan y desperdician espacio en el disco cuando se ejecutan. Aborde las advertencias con prontitud.
Eliminando /var/lib/flatpak: Esto eliminará todas las aplicaciones. Nunca hagas esto a menos que limpies intencionalmente el Flatpak.
Ejecute la solución sin sudo: Verás «assuming --dry-run«Y nada cambiará. Utilice siempre privilegios de root.
Edite manualmente los metadatos de Flatpak: No edites archivos manualmente /var/lib/flatpak/. Utilice el comando de reparación oficial.
salte por encima’flatpak uninstall --unused‘: Los tiempos de ejecución obsoletos permanecen en el disco. Asegúrese de limpiar después de las reparaciones.

Cuándo no utilizar esta solución

No utilice esta solución si:

Error de E/S de disco: El registro del sistema muestra un error de lectura/escritura del disco. Primero resuelva el problema del hardware de almacenamiento.
Corrupción del sistema de archivos: correr fsck Verifique la integridad del sistema de archivos antes de continuar.
Fallo del hardware de almacenamiento: Verifique los datos INTELIGENTES smartctl. Reemplace la unidad fallida.
Inestabilidad completa del sistema: Si fallan varios componentes, es posible que sea necesario reinstalar el sistema operativo.

Primero verifique los registros de su sistema:

sudo journalctl -xe | grep -i error
sudo dmesg | grep -i 'I/O error'

Si ve errores en el disco, primero repare la capa de hardware antes de intentar reparar Flatpak.

Preguntas frecuentes

P: ¿Esta solución desinstalará mi aplicación?

uno: No. Estos comandos solo borran el caché de metadatos y eliminan el tiempo de ejecución no utilizado. Sus aplicaciones instaladas permanecen intactas y funcionales durante todo el proceso.

P: ¿Necesito ejecutar estos comandos cada vez que actualizo?

uno: No. Esta es una solución única para la falta de coincidencia de metadatos. Será normal después de solucionarlo. flatpak update El comando debería funcionar sin errores.

P: ¿Puedo usar esta solución en Ubuntu/Debian/Fedora/Arch?

uno: Sí. Esta solución funciona en todas las distribuciones de Linux que utilizan Flatpak, incluidas Ubuntu, Debian, Fedora, openSUSE, Arch, Manjaro, Pop!_OS, Linux Mint y más.

P: ¿Qué debo hacer si veo un error en una aplicación instalada por el usuario (~/.local/share/flatpak)?

uno: Ejecute el mismo comando pero reemplace --system y --user y ajustar la ruta:

rm -rf ~/.local/share/flatpak/repo/tmp/* rm -rf ~/.local/share/flatpak/repo/refs/remotes/flathub flatpak repair --user

P: ¿Cuánto espacio en disco liberaré?

uno: Depende de cuántos tiempos de ejecución antiguos tengas. La eliminación de tiempos de ejecución no utilizados puede liberar entre 100 MB y varios GB de espacio. Comprueba el antes y el después usando el siguiente comando:

du -sh /var/lib/flatpak

en conclusión

El error «No existe tal referencia en Flathub remoto» puede parecer aterrador, pero suele ser un simple problema de sincronización de metadatos. Al borrar las referencias almacenadas en caché y realizar las reparaciones adecuadas del sistema, puede restaurar la coherencia entre el repositorio Flatpak local y el estado remoto de Flathub.

Puntos clave:

El error no es fatal y no interrumpirá su aplicación.
Cuatro comandos simples para resolver el problema de forma segura
Utilice siempre sudo para los comandos de reparación
Nunca borrar /var/lib/flatpak o ~/.local/share/flatpak Tabla de contenido
Limpiar tiempos de ejecución no utilizados para recuperar espacio en disco

Si encuentra errores persistentes después de seguir esta guía, verifique los registros de su sistema para detectar problemas de hardware antes de continuar.

Recursos adicionales:

Para informar un error o problema de Flatpak con una aplicación específica, visite el repositorio de Flatpak GitHub o el rastreador de problemas de la aplicación correspondiente en Flathub.

Etiquetas