La función funciona en preparación o cuando la optimización está deshabilitada, pero la producción informa un error dentro de un paquete minimizado de una línea. El código original puede depender del orden de ejecución, contener una sintaxis que el optimizador maneja mal o combinarse con una dependencia obsoleta.
Primero restaure el recorrido crítico del usuario y luego reproduzca la transformación fallida más pequeña.
Captar el fracaso público con precisión
Pruebe como visitante desconectado y registre la página, la acción, el navegador, el texto de error, la URL del script y la línea/columna. Guarde el seguimiento de la pila y el estado de respuesta de la red.
Compruebe si el error ocurre en la primera carga, después de navegar entre páginas o solo después de abrir un componente. Un visitante almacenado en caché puede recibir un paquete diferente de una sesión nueva.
Si los formularios o el proceso de pago no funcionan, utilice la opción de omisión admitida por el optimizador o desactive la transformación de JavaScript específica durante el diagnóstico. Mantenga documentada la configuración anterior.
Confirmar qué etapa de optimización lo causa
En la puesta en escena, pruebe estos estados por separado:
- expedientes individuales originales;
- minimizados pero no combinados;
- combinado sin minificación;
- retrasado o diferido después de la minificación;
- la configuración de producción completa.
El primer estado donde aparece el error limita la causa. No alterne minimizar, combinar y retrasar juntos y llame al grupo "el optimizador".
Mantenga el tema, las versiones de plugins y el contenido de la página alineados con la producción para que la comparación sea significativa.
Reasignar el paquete a los archivos fuente
Utilice el modo de manifiesto, comentario de origen o depuración del optimizador para enumerar los archivos dentro del paquete. Busque fuentes originales para la función que falla o una cadena cercana.
Si se produce un mapa fuente legítimo, las herramientas de desarrollo del navegador pueden asignar la pila a la línea original. No exponer públicamente mapas de fuentes privadas simplemente para facilitar el diagnóstico; configurar el acceso según la política de seguridad del proyecto.
Compare el contenido de la respuesta con el manifiesto actual. Una CDN puede ofrecer un paquete antiguo bajo una URL reutilizada.
Busque dependencias del orden de ejecución
La combinación de archivos puede cambiar el orden cuando las dependencias se expresaban solo mediante etiquetas de script separadas. Un plugin podría esperar que jQuery o un objeto de configuración global exista primero.
Los scripts de WordPress deben registrar las dependencias explícitamente. El código personalizado puede utilizar:
wp_enqueue_script(
'site-checkout',
get_stylesheet_directory_uri() . '/js/checkout.js',
array('jquery', 'wc-checkout'),
'1.4.0',
true
);Utilice mangos reales verificados. No copie este ejemplo de pago en un sitio que registre diferentes dependencias.
Los datos en línea "antes" y "después" deben permanecer al lado del identificador correcto. Moverlo a un añadedo puede invertir la secuencia requerida.
Verifique la sintaxis y las transformaciones inseguras
Los minificadores más antiguos pueden fallar en la sintaxis de JavaScript, las expresiones regulares o el código más nuevo que depende de los nombres de funciones/clases. Es posible que los scripts de terceros ya estén minimizados y no deban procesarse nuevamente.
Excluya de la minificación el archivo probado más pequeño conservando su orden de carga normal. Si es propietario de la fuente, actualice la herramienta de compilación o corrija el código inseguro en lugar de mantener una exclusión amplia permanente.
Nunca edite manualmente el paquete de una línea generado; será regenerado y no es la fuente de la verdad.
Eliminar combinaciones de caché obsoletas
Versione las URL del paquete cuando cambie su contenido. Purgue el HTML afectado y la URL exacta del recurso a través de controles compatibles y luego pruebe una sesión nueva.
Un nuevo documento HTML que hace referencia a un paquete antiguo eliminado genera un error 404; El HTML antiguo que hace referencia a un paquete recién sobrescrito puede crear código incompatible. La implementación atómica o los nombres de archivos con contenido hash evitan esa discrepancia.
No vacíe cada caché de producción repetidamente. Aumenta la carga de origen y hace que la falla sea más difícil de reproducir.
Ejecutar comprobaciones de regresión
Después de la reparación limitada, pruebe la navegación, los formularios, el consentimiento, los controles deslizantes y los flujos de pago autorizados. Revise la consola en varias plantillas y navegadores.
Confirme que el recurso de producción se minimice o excluya exactamente como se esperaba, se cargue una vez y permanezca estable durante una segunda visita en caché. Registre el archivo responsable y el motivo de la exclusión para que una futura actualización del plugin solicite una revisión.
Solicite una evaluación cuando el manifiesto del paquete no esté disponible, diferentes capas de caché proporcionen código inconsistente o existan dependencias de pago/formulario. Comparta primero la evidencia pública de errores y organice el acceso seguro solo después de que se acuerde el alcance.