tail -100 logs/app.log | grep -A 10 "ERROR"Start from the innermost layer (core/database) and work outward to HTTP. Don’t debug through the full stack when you can isolate the issue.
tail -100 logs/app.log | grep -A 10 "ERROR"Errors are logged with stack traces. Look for the first non-Boundary frame in the trace.
;; Output appears in REPL/server stdout, not log files
(println "DEBUG:" {:field value :other other-value})Remove all println statements before committing.
Bypass the HTTP layer and call services directly:
(def user-svc (get integrant.repl.state/system :boundary/user-service))
(ports/find-user-by-email user-svc "alice@example.com")Add temporary logging in handlers:
(println "DEBUG request:"
{:method (:request-method request)
:params (:params request)
:headers (select-keys (:headers request) ["hx-request" "authorization"])})(def ds (get-in integrant.repl.state/system [:boundary/db-context :datasource]))
(require '[next.jdbc :as jdbc])
(jdbc/execute! ds ["SELECT * FROM users WHERE email = ?" "alice@example.com"])nil where a field value is expectedCause: snake_case / kebab-case mismatch.
Check: is the field :password_hash (snake) where the code expects :password-hash (kebab)?
Fix: always use cc/snake-case→kebab-case-map at the persistence boundary.
ig-repl/reset didn’t pick up changesCause: You changed a defrecord.
Fix:
(ig-repl/halt)
(ig-repl/go)Cause: An ex-info without :type, or an unwrapped Java exception.
Fix: wrap in try-catch with a typed error:
(try
(UUID/fromString id-string)
(catch IllegalArgumentException _
(throw (ex-info "Invalid UUID" {:type :validation-error :value id-string}))))Cause: Schema and database migration are out of sync.
Fix: check that the field exists in both schema.clj, the migration SQL, and shell/persistence.clj.
Fix:
JWT_SECRET="dev-secret-32-chars-minimum" clojure -M:test:db/h2 :userCan you improve this documentation?Edit on GitHub
cljdoc builds & hosts documentation for Clojure/Script libraries
| Ctrl+k | Jump to recent docs |
| ← | Move to previous article |
| → | Move to next article |
| Ctrl+/ | Jump to the search field |