Lucee Debugger Extension in VSCode

dev support
1

I installed the extension davidrogers.luceedebug, but it shows the version 2.0.12.
When i configure the launch.json, the property secret is not allowed.
I downloaded the source code, build the extension and replaced the files with the new files. Then the extension didn’t start:

Debug adapter process has terminated unexpectedly (Extension host shut down)
I deleted the extension, restarted vsc and installed the extension from marketplace again.
With version 2.0.12, I call > luceedebug: show class and breakpoint info:

Breakpoints luceedebug has:
  (ide)    /Users/mmmm/Documents/xxx/yyy/abc/index.cfm:4 (unbound)
  (server) /home/abc/index.cfm:4 (unbound)

Path transforms:
  PrefixPathTransform{idePrefix='/Users/mmmm/Documents/xxx/yyy/abc/', serverPrefix='/home/abc'}

Files luceedebug knows about (all filenames are as the server sees them, and match against breakpoint 'server' paths):

(Before I build the extension manually, I saw some files…, so I guess i broke it…)

My questions: Is a the new extension in the market place to use?
How can I get this run?
curl/nmap says, the port 10000 is running/open on localhost

OS: MacOS with lucee running in docker
Lucee Version: 7.1.0.115-SNAPSHOT

2

Try the v3 Lucee version?

1 Like
3

Sorry, was not clear from my side:

I downloaded the source code, build the extension and replaced the files with the new files. Then the extension didn’t start:
Debug adapter process has terminated unexpectedly (Extension host shut down)

I build and installed v3 again, now the extension is running:

CleanShot 2026-05-08 at 08.44.40
CleanShot 2026-05-08 at 08.44.40787×466 59.6 KB

luceedebug: show class and breakpoint info shows my set breakpoint at index.cfm and 730 files

I request the index.cfm in the browser and the pages loads, loads, loads and nothing happens. The watch/variables in the IDE are not populated. The small menu bar with “Continue / Step Over / Step Into” is shown and after some seconds the debugger stops. The page then loads as ususal.

I restarted the IDE and now luceedebug: show class and breakpoint info shows my unbound breakpoint and no more files.

I use the docker to mount server folders into one folder:

volumes:
      - ${myfolder}:/home/project_1/
      - ${myfolder}:/home/project_2/

The server.xml:

<Host name="project1" appBase="webapps">
<Context path="" docBase="/home/project_1"
</Host>
...

The launch.json:

PrefixPathTransform{idePrefix='/Users/.../project_x', serverPrefix='/home/project1'}
...

How can I get the debugger running? Thanks for your help!

4

nevermind, i found it:

I still had the old debugger in the setenv.sh enabled, so the port 10000 was used by the old debugger. I removed the file, removed the old luceedebugger.jar and rebuild docker.

the Debug Console now shows:

[luceedebug] luceedebug 3.0.0.5-SNAPSHOT connected to Lucee 7.1.0.116-SNAPSHOT
[luceedebug] Registered native debugger listener
...

The variables and watch-scope is populated and everything is running. A perfect timing, I need the debugger today really…

5

Ok, one last issue. When i debug and read the variables scope:

[luceedebug] ERROR: Launcher future exception: java.lang.StackOverflowError
java.util.concurrent.ExecutionException: java.lang.StackOverflowError
	at java.base/java.util.concurrent.FutureTask.report(FutureTask.java:122)
	at java.base/java.util.concurrent.FutureTask.get(FutureTask.java:191)
	at org.eclipse.lsp4j.jsonrpc.json.ConcurrentMessageProcessor$1.get(ConcurrentMessageProcessor.java:54)
	at org.eclipse.lsp4j.jsonrpc.json.ConcurrentMessageProcessor$1.get(ConcurrentMessageProcessor.java:50)
	at org.lucee.extension.debugger.DapServer.createForSocket(DapServer.java:258)
	at org.lucee.extension.debugger.extension.ExtensionActivator.lambda$new$0(ExtensionActivator.java:83)
	at java.base/java.lang.Thread.run(Thread.java:1583)
Caused by: java.lang.StackOverflowError
	at lucee.commons.collection.concurrent.ConcurrentHashMapNullSupportJDK$EntrySetView$1$1.hashCode(ConcurrentHashMapNullSupportJDK.java:464)
	at lucee.commons.collection.concurrent.ConcurrentHashMapNullSupportJDK.hashCode(ConcurrentHashMapNullSupportJDK.java:634)
	at lucee.runtime.type.StructImpl.hashCode(StructImpl.java:358)
	at lucee.commons.collection.concurrent.ConcurrentHashMapNullSupportJDK$EntrySetView$1$1.hashCode(ConcurrentHashMapNullSupportJDK.java:464)
	at lucee.commons.collection.concurrent.ConcurrentHashMapNullSupportJDK.hashCode(ConcurrentHashMapNullSupportJDK.java:634)
	at lucee.runtime.type.StructImpl.hashCode(StructImpl.java:358)
	at lucee.commons.collection.concurrent.ConcurrentHashMapNullSupportJDK$EntrySetView$1$1.hashCode(ConcurrentHashMapNullSupportJDK.java:464)
	at lucee.commons.collection.concurrent.ConcurrentHashMapNullSupportJDK.hashCode(ConcurrentHashMapNullSupportJDK.java:634)
	at lucee.runtime.type.StructImpl.hashCode(StructImpl.java:358)
	at lucee.commons.collection.concurrent.ConcurrentHashMapNullSupportJDK$EntrySetView$1$1.hashCode(ConcurrentHashMapNullSupportJDK.java:464)
	at lucee.commons.collection.concurrent.ConcurrentHashMapNullSupportJDK.hashCode(ConcurrentHashMapNullSupportJDK.java:634)
	at lucee.runtime.type.StructImpl.hashCode(StructImpl.java:358)
	at lucee.commons.collection.concurrent.ConcurrentHashMapNullSupportJDK$EntrySetView$1$1.hashCode(ConcurrentHashMapNullSupportJDK.java:464)
	at lucee.commons.collection.concurrent.ConcurrentHashMapNullSupportJDK.hashCode(ConcurrentHashMapNullSupportJDK.java:634)
	at lucee.runtime.type.StructImpl.hashCode(StructImpl.java:358)
	at lucee.commons.collection.concurrent.ConcurrentHashMapNullSupportJDK$EntrySetView$1$1.hashCode(ConcurrentHashMapNullSupportJDK.java:464)
	at lucee.commons.collection.concurrent.ConcurrentHashMapNullSupportJDK.hashCode(ConcurrentHashMapNullSupportJDK.java:634)
	at lucee.runtime.type.StructImpl.hashCode(StructImpl.java:358)
....
6

thanks for the bug report