Un plugin que funcionaba en PostgreSQL y se caía en MariaDB: lo que nos enseñó un aviso de un usuario

cincocreative_17468 cincocreative_17468 Noticias Plugin AIDocumentos Fecha de creación: 18-09-2026 10:34:04 Última actualización: 18-09-2026 Contador de visitas: 273

Ayer por la tarde un usuario nos escribió con dos mensajes de error que le salían en AIDocumentos:

You have an error in your SQL syntax; check the manual that corresponds to your MariaDB server version for the right syntax to use near ') FROM 1 FOR 7) AS mes, COUNT(*) AS total, COUNT(CASE WHEN estado = 'importad...'

Estaba corregido y publicado esta mañana. Pero lo interesante no es el arreglo, que son cuatro líneas: es por qué no lo habíamos visto nosotros.

Un plugin, dos bases de datos

FacturaScripts funciona sobre PostgreSQL y sobre MySQL/MariaDB. Los dos hablan SQL, pero no exactamente el mismo SQL.

La pantalla de métricas de AIDocumentos agrupa los documentos por mes. Para eso recortaba los siete primeros caracteres de la fecha, así:

SUBSTRING(CAST(fecha AS VARCHAR) FROM 1 FOR 7)

En PostgreSQL funciona. En MySQL y MariaDB no existe el tipo VARCHAR dentro de un CAST — ahí se llama CHAR — así que el servidor rechaza la consulta entera. No es que devuelva un dato raro: es que no llega a ejecutarse, y la pantalla no se pinta.

Nuestro entorno de pruebas es PostgreSQL. Todas las pruebas pasaban. Y el plugin estaba roto para todo el que use MariaDB, que en hostings compartidos es la mayoría.

Lo que apareció al buscar lo mismo en los demás plugins

Un fallo así nunca viene solo. Buscando el mismo patrón en los 25 plugins apareció otro caso, en btransfer, y este era peor: el mismo SQL de PostgreSQL, pero envuelto en un try/catch para que la pantalla no se rompiera. Resultado en MariaDB: el recuadro de «envíos de este mes» mostraba 0 envíos, 0 archivos, 0 bytes aunque hubieras enviado diez cosas esa semana.

Un error visible es molesto. Un cero silencioso es peor: nadie escribe para preguntar, simplemente deja de fiarse del plugin.

Qué hemos cambiado, además del arreglo

Arreglar dos consultas es lo de menos. Lo que hacía falta era dejar de ser ciegos a esta familia entera de fallos, y para eso van tres cosas:

1. Un segundo entorno de pruebas sobre MariaDB. Ahora hay dos instalaciones de FacturaScripts que comparten la misma carpeta de plugins: una sobre PostgreSQL y otra sobre MariaDB. Lo que se arregla vale para las dos, y las dos se prueban antes de publicar nada.

2. Los 46 controladores se montan contra los dos motores. No solo las consultas escritas a mano: cada pantalla de cada plugin levanta sus vistas contra MariaDB y se comprueba que ninguna suelta un error de sintaxis.

3. Un revisor que no deja pasar SQL de un solo motor. Busca en el código los sospechosos habituales de los dos lados — CAST(... AS VARCHAR), ::text, ILIKE, DATE_TRUNC, TO_CHAR de PostgreSQL; DATE_FORMAT, IFNULL, GROUP_CONCAT, LIMIT a,b de MySQL — y si encuentra uno, no se publica.

Qué tienes que hacer

Si usas MySQL o MariaDB y te salían esos mensajes en AIDocumentos, actualiza a la 9.3. Si usas btransfer y el recuadro del mes te salía a cero, actualiza a la 2.3. En los dos casos: Panel de control > Plugins > Actualizar. No se pierde nada, ni hace falta tocar la configuración.

Si usas PostgreSQL, nunca te afectó ninguno de los dos.

Y gracias

Este fallo lo encontró un usuario que se tomó la molestia de copiar el mensaje de error y mandarlo, en vez de desinstalar y seguir con su día. Si algo no te cuadra en cualquiera de nuestros plugins, dilo: se arregla antes de lo que parece.


Amplía tus conocimientos con los cursos oficiales

Curso de Documentos Recurrentes
1 h 30 min
Plugin DocumentosRecurrentes Nuevo

Curso de Documentos Recurrentes

Aprenderás a crear y configurar documentos recurrentes en FacturaScripts, definir sus líneas y periodicidad, generar documentos manual y...

9 lecciones

Curso de Recursos Humanos para empleados
28 min
Plugin HumanResources Nuevo

Curso de Recursos Humanos para empleados

Este curso está dirigido a trabajadores de empresas que utilizan Recursos Humanos para registrar su jornada y consultar información...

4 lecciones

Curso de Amortizaciones
1 h 5 min
Plugin Amortizaciones Nuevo

Curso de Amortizaciones

Aprende a gestionar los inmovilizados de tu empresa y los préstamos bancarios con el plugin Amortizaciones para FacturaScripts,...

8 lecciones

Patrocinadores

Estas empresas y profesionales apoyan económicamente FacturaScripts y nos ayudan a dedicar más tiempo al desarrollo, las pruebas y la documentación.

ORO
PLATA
BRONCE
PRO
mililitrosdeperfume_lao
mililitrosdeperfume_lao
eduardo_12367
eduardo_12367
miguel.garcia_l25
miguel.garcia_l25
carlos
carlos
daniel89fg
daniel89fg
yopli2000_5
yopli2000_5
adelantia_8n
adelantia_8n
esteban
esteban
davidpujantelopez_mrf
davidpujantelopez_mrf
luis_12743
luis_12743
gestion_kw4
gestion_kw4
mariano_6807
mariano_6807
juancarlos_ptr
juancarlos_ptr
jmoreno_2610
jmoreno_2610
galonso_12031
galonso_12031
jtovar_opt
jtovar_opt
ssantofimioq_mbk
ssantofimioq_mbk
carmen_qua
carmen_qua
chefe_qvz
chefe_qvz
rafael.cosquiere_qw0
rafael.cosquiere_qw0
antoniommoranrubio_qvj
antoniommoranrubio_qvj
jmboqui_qw3
jmboqui_qw3
miriam_qt0
miriam_qt0
rubaraja_15078
rubaraja_15078
euroviane_qmo
euroviane_qmo
jserrano_qv8
jserrano_qv8
djs2035_pha
djs2035_pha
pedropccribeiro_ppz
pedropccribeiro_ppz
mgila.contabilidad_qw9
mgila.contabilidad_qw9
elimbroda_ohe
elimbroda_ohe
ivancuello_qwj
ivancuello_qwj
urban_qwk
urban_qwk
mariojimenezcruz33_mx3
mariojimenezcruz33_mx3
radiotesla2011.008_qwo
radiotesla2011.008_qwo
rrespaldo430_22233
rrespaldo430_22233
calle.laplata.41_n6s
calle.laplata.41_n6s
marcossanzlatorre_o8v
marcossanzlatorre_o8v
roberto.a.paneque_qx4
roberto.a.paneque_qx4
jurgen_qx2
jurgen_qx2
leivair_qgm
leivair_qgm
victor.exland_7712
victor.exland_7712
bluehservice_18942
bluehservice_18942
jgarrancho_qvi
jgarrancho_qvi
proyecto.ronin49_qxd
proyecto.ronin49_qxd
gesebi_74c
gesebi_74c
supmanagement_qxf
supmanagement_qxf
liliosot_qxq
liliosot_qxq
mariansomesa_qt2
mariansomesa_qt2
andrea.vives_qxe
andrea.vives_qxe
carlosmorenogil_16533
carlosmorenogil_16533
myles_qxy
myles_qxy
jorge849_qy2
jorge849_qy2
compra_q6p
compra_q6p
juanrmoreira371_qw2
juanrmoreira371_qw2
aferinoxidables_oa0
aferinoxidables_oa0
a.useropelaez_qy7
a.useropelaez_qy7
fran.cornide_qyl
fran.cornide_qyl
dwujgnmxwk_qwb
dwujgnmxwk_qwb
clave80detectives_qr6
clave80detectives_qr6
oscarsoler71_k7r
oscarsoler71_k7r
jrodriguezlinar_qyx
jrodriguezlinar_qyx
david_qyz
david_qyz
pescanelasl_qz1
pescanelasl_qz1
vilaboa.angel_qz4
vilaboa.angel_qz4
ferrervicent_89t
ferrervicent_89t
raljopa_851
raljopa_851
eurogaran_nct
eurogaran_nct
hospitalaria_18966
hospitalaria_18966
administracion_qzl
administracion_qzl
it_qzm
it_qzm
ezequieltotoras_4123
ezequieltotoras_4123
hermes6686_oc2
hermes6686_oc2
marcel_qzr
marcel_qzr
rie_17672
rie_17672
maximilianoalameddin_qyp
maximilianoalameddin_qyp
imentsociedadlimitada_qzs
imentsociedadlimitada_qzs
carlos.benitez.hurtado_qzu
carlos.benitez.hurtado_qzu
miquel_qzy
miquel_qzy
danieltorresh2_r01
danieltorresh2_r01
perezvallejoa_qww
perezvallejoa_qww
mbenitezsan_r07
mbenitezsan_r07
alegria_r08
alegria_r08
crismer_r09
crismer_r09
fernandogbj_3fk
fernandogbj_3fk
hola_r0h
hola_r0h
auto-marner_r0g
auto-marner_r0g
it_r0n
it_r0n
salonmanuelafernandez_qgy
salonmanuelafernandez_qgy
tinorubiorollon_r0s
tinorubiorollon_r0s
fegugo1_qs5
fegugo1_qs5
limicompanysrl_qzn
limicompanysrl_qzn
spinardo_qzd
spinardo_qzd
bmg_r11
bmg_r11
raultvmusic_2402
raultvmusic_2402
yeisoncruz01_r13
yeisoncruz01_r13
mis_hierbitas_qvy
mis_hierbitas_qvy
ismasans_r14
ismasans_r14
merabyte_r18
merabyte_r18
cnovas.sanchez_r1b
cnovas.sanchez_r1b
autein_qu9
autein_qu9
paco100416_p0l
paco100416_p0l
r.raul.reinoso_r1m
r.raul.reinoso_r1m
dabos1705_n6y
dabos1705_n6y
davidgf7orellana_qvk
davidgf7orellana_qvk
vyxa.web_r1n
vyxa.web_r1n
radtotalcar_r1p
radtotalcar_r1p
businessgioglobal_qc9
businessgioglobal_qc9
casteret_r1q
casteret_r1q
piratapmc_r23
piratapmc_r23
jekaseo_qbu
jekaseo_qbu

Si quieres impulsar nuevas mejoras y ayudar a que el proyecto siga creciendo, conviértete en patrocinador y forma parte de quienes lo hacen posible.

Patrocinar

Cookies
Usamos cookies necesarias para el funcionamiento del sitio y cookies opcionales para recordar tus preferencias y mejorar tu experiencia. Puedes aceptarlas todas, rechazarlas o configurar tus preferencias

Soporte