Přeskočit na obsah

Dávková úloha s limitem před filtrem — starší nezpracovatelné položky trvale blokují ty za nimi

import { Aside } from ‘@astrojs/starlight/components’;

Opravná úloha měla dokončit kroky, které čekají na splnění podmínky (například na doklad nebo na změnu stavu). Jedna položka podmínku splnila, ale úloha ji ani po mnoha bězích nedokončila. V logu nebyla žádná chyba a souhrn běhu hlásil „nic k práci“. Ruční spuštění téže úlohy s velkým limitem položku dokončilo okamžitě.

V systému se stejná vada projevila na dvou místech: u položek, které čekají na podmínku, a dřív u položek, které úloha vědomě přeskakuje.

Výběr a rozhodnutí byly rozdělené mezi databázi a kód:

const rows = await db.task.findMany({
where: { state: "waiting" },
orderBy: { createdAt: "asc" },
take: 25, // limit se uplatní TADY
});
for (const row of rows) {
if (!(await isReady(row))) continue; // …a o zpracovatelnosti se rozhodne až TADY
await process(row);
}

Řádek, který zpracovat nejde, zůstane ve stejném stavu se stejným createdAt. Příští běh proto vybere přesně stejných 25 řádků. Jakmile se na začátku fronty nahromadí 25 nezpracovatelných, úloha se zasekne natrvalo a vše za nimi hladoví. Čím déle systém běží, tím je to pravděpodobnější.

Vadu neodhalí test s jednou nebo dvěma položkami ani ruční spuštění bez limitu.

Podmínku zpracovatelnosti nešlo vyjádřit v SQL (čte se z jiných tabulek a služeb), proto se posouvá pořadí:

const rows = await db.$queryRaw`
SELECT * FROM "Task" WHERE state = 'waiting'
ORDER BY "checkedAt" NULLS FIRST, "createdAt" -- od nejdéle nekontrolovaných
LIMIT ${limit}`;
for (const row of rows) {
if (await isReady(row)) { await process(row); continue; }
await db.$executeRaw`UPDATE "Task" SET "checkedAt" = now() WHERE id = ${row.id} AND state = 'waiting'`;
}
  • Zkontrolovaný a nezpracovaný řádek dostane čas kontroly a zařadí se na konec. Další běh začne u řádků, které na kontrolu čekají déle.
  • Po celém kole se úloha k řádku vrátí, takže zachytí i podmínku splněnou později.
  • Čas kontroly se zapíše i tehdy, když kontrola jedné položky skončí chybou — jinak blokuje opakovaně selhávající řádek.
  • Nový řádek vzniká s časem kontroly rovným okamžiku vzniku, ne s hodnotou v budoucnosti; jinak by se právě zkontrolované řádky řadily před něj.

Samotné zvýšení limitu nepomáhá, jen posouvá hranici, od které se úloha zasekne.

Jak se tomu vyvarovat v jiných systémech

Sekce “Jak se tomu vyvarovat v jiných systémech”
  • Detection: hledej take / LIMIT v dávkových úlohách a zkontroluj, zda se po něm v kódu ještě něco přeskakuje (continue, if (!…) return). Pokud ano a přeskočený řádek nemění stav ani pořadí, je to tento bug.
  • Test: připrav přesně tolik nezpracovatelných řádků, kolik je limit, a jeden zpracovatelný za nimi. Pusť úlohu dvakrát bez posunu času. Přidej i případ, kdy se zpracovatelným stane řádek, který už úloha navštívila.
  • Anti-pattern: „vezmi N nejstarších a uvidíme“ nad stavem, který se neúspěšnou kontrolou nezmění.
  • Lepší přístup, pokud to jde: filtr dostat celý do dotazu, aby limit platil až na zpracovatelné řádky. Když to nejde, čas poslední kontroly nebo trvalý ukazatel postupu. Po vyčerpání pokusů řádek převést do koncového stavu, aby z fronty zmizel.
  • Souhrn běhu: hlásit i počet zkontrolovaných a přeskočených řádků. „Nic k práci“ při plné frontě je signál, ne klid.

Sister bugs / související

Sekce “Sister bugs / související”
Přidal aiarchitekt.cz · 16. 11. 2026 1:00
Provozuje aiarchitekt.cz