🧩 Recomendaciones para solucionar errores comunes en Salesforce
⚠️ Error System.LimitException: Too many query rows: 50001 en Salesforce (NPSP)
Cuando se produce el siguiente error durante una actualización masiva en Salesforce:
Apex script unhandled exception by user/organization: [ID_USUARIO]/[ID_ORGANIZACION]
System.LimitException: npsp:Too many query rows: 50001
Es importante seguir un conjunto de pasos para identificar la causa y aplicar soluciones efectivas. Este error ocurre cuando una transacción supera el límite de 50.000 filas retornadas por consultas SOQL en Apex.
🔍 1. Revisar el límite de filas de consulta
El mensaje Too many query rows: 50001 significa que una consulta ha devuelto más filas de las permitidas en una sola ejecución.
✅ Acciones:
- Evaluar cuántos registros se están procesando en la operación masiva.
- Reducir el tamaño del lote para evitar alcanzar el límite.
⚙️ 2. Modificar el tamaño del lote (batch size)
Salesforce permite configurar lotes de hasta 200 registros. Sin embargo, si hay automatizaciones como Flows o Process Builders, esto puede generar múltiples llamadas y superar fácilmente el límite de filas consultadas.
🔧 Recomendaciones:
- Utilizar Data Loader o herramientas similares para configurar un batch size menor:
20,30o50. - Probar con distintos valores hasta encontrar el óptimo que permita completar la operación sin errores.
🔁 3. Verificar Process Builders y Flujos activos
Los Process Builders y Flows pueden generar consultas y operaciones adicionales cuando se actualizan registros, aumentando el riesgo de alcanzar el límite de filas.
🛠️ Acciones sugeridas:
- Identificar todos los flujos y procesos activos que afectan los objetos involucrados.
- Desactivarlos temporalmente para validar si están contribuyendo al error.
- Documentar qué automatizaciones se ejecutan durante la operación masiva.
🧮 4. Revisar Roll-Ups activos
Los roll-ups pueden ejecutarse automáticamente al modificar ciertos objetos, generando actualizaciones masivas en cascada.
📌 Pasos a seguir:
- Identificar los roll-ups activos en los objetos afectados.
- Evaluar si estas reglas están generando múltiples consultas indirectas.
- Considerar desactivarlos temporalmente o reprogramar su ejecución.
📦 5. Evaluar configuración de lotes en NPSP
El paquete Nonprofit Success Pack (NPSP) posee configuraciones internas de procesamiento por lotes que también pueden influir en este error.
🔍 Acciones:
- Revisar la configuración del batch size en NPSP.
- Ajustarlo si se sospecha que está procesando más registros de lo necesario.
🖼️ Imágenes relacionadas
A continuación se presentan ejemplos visuales relacionados con la configuración y monitoreo de lotes:



✅ Conclusión
El error System.LimitException: Too many query rows: 50001 puede resolverse si se implementan medidas preventivas y correctivas como:
- Reducir el tamaño de los lotes.
- Identificar automatizaciones innecesarias o redundantes.
- Ajustar configuraciones específicas del paquete NPSP.
- Probar por etapas y monitorear los resultados.
🧠 Consejo final: Siempre realizar pruebas controladas antes de ejecutar operaciones masivas en producción.