no-unsafe-query
Prevent SQL injection by disallowing string concatenation or interpolated template literals in knex.raw() calls.
CWE: CWE-89 OWASP: A03:2021 – Injection
Detects SQL injection in Knex raw queries. This rule is part of eslint-plugin-knex-security.
💼 This rule is set to error in the recommended config.
Quick Summary
| Aspect | Details |
|---|---|
| CWE Reference | CWE-89 (SQL Injection) |
| Severity | Critical (CVSS 9.8) |
| Auto-Fix | ❌ No auto-fix available |
| Category | Security |
Rule Details
Reports three shapes when they reach a raw-SQL sink:
- String concatenation —
knex.raw('SELECT ... ' + value) - Template interpolation —
knex.raw(`SELECT ... ${value}`) - A variable tainted by either, including via
+=, then passed to a sink
Sinks
knex.raw() and .raw() on a query builder.
❌ Incorrect
await knex.raw(`SELECT * FROM users WHERE id = ${userId}`);
await knex.raw('SELECT * FROM users WHERE email = ' + email);
let sql = 'SELECT * FROM products WHERE 1=1';
sql += ` AND name = '${name}'`;
await knex.raw(sql);✅ Correct
knex.raw('SELECT * FROM users WHERE id = ?', [userId]);Known limitations
- Only identifier member access is matched, so
knex['raw'](...)is a false negative. - Taint tracking is single-scope and name-based — it does not follow a query string across function boundaries.
Implementation
The detection is shared across the driver plugins via createSqlInjectionRule
in @interlace/eslint-devkit; this rule supplies Knex's sinks and
remediation copy. Install the plugin matching your stack and you get exactly
one finding per line.
Further Reading
Did this rule catch something? Star the repo to get new CWE coverage as we ship it — or follow the AI-code-security benchmarks behind these rules.
no-mass-assignment
Disallow writing an inbound request object straight to the database through knex, which lets the caller set every column the model exposes.
no-unscoped-mutation
Require a chained `.where()` on Knex delete and update builders, so a bulk mutation cannot rewrite or delete every row in the table.