Troubleshooting

faker:spec:generate produces an empty or incomplete spec

The generator only introspects QModel entities registered via EntityStore at the time the command runs. Boot the application (or explicitly register entities) before running the command.

Unique field generation fails after many rows

Unique-value enforcement retries a generator up to 100 times per row before failing. For large count values with low-cardinality generators (e.g. a small enum), unique values will run out — use a higher-cardinality generator or lower the count.

Anonymize mode overwrote a field it shouldn't have

Mark any field that must survive anonymization (PKs, FKs, timestamps, or business-critical values) with "skip": true in the spec before running faker:anonymize.

QFakerError on an unknown generator path

fields[x].generator must be a valid dot-path into the @faker-js/faker API (e.g. "person.fullName"). Check the Faker.js API docs for the exact method path.