Skip to content

Fix Windows Spring Boot Process Application Resource Scanning in 3.0.0 - #290

Open
ryans58 wants to merge 1 commit into
finos:mainfrom
summit58llc:hotfix/3.0-windows-sb-deployment-fix
Open

Fix Windows Spring Boot Process Application Resource Scanning in 3.0.0#290
ryans58 wants to merge 1 commit into
finos:mainfrom
summit58llc:hotfix/3.0-windows-sb-deployment-fix

Conversation

@ryans58

@ryans58 ryans58 commented Aug 24, 2026

Copy link
Copy Markdown

Summary

Fixes Windows Spring Boot process application resource scanning when using @EnableProcessApplication with an empty META-INF/processes.xml.

Beginning with Fluxnova 2.0.3, ClassPathProcessApplicationScanner can receive a Windows drive-letter path from URL.getPath() in the form:

/C:/dev/fluxnova-loan-review/target/classes/META-INF/processes.xml

Passing that value directly to Paths.get(String) causes Windows to reject the drive-letter colon with:

java.nio.file.InvalidPathException:
Illegal char <:> at index 2

Change

The scanner now normalizes this specific Windows path representation before passing it to Paths.get(...):

/C:/dev/... -> C:/dev/...

The change is intentionally narrow and preserves the existing resource-scanning and path-normalization behavior for other platforms and resource types.

A focused unit test has also been added to cover Windows drive-letter path normalization without requiring the test suite itself to run on Windows.

Validation

The fix has been validated against the full Fluxnova test suite using:

mvn clean install

The patched scanner has also been successfully tested with a Spring Boot process application on Linux.

Windows validation has been performed against the affected Fluxnova releases using a Spring Boot process application with:

  • @EnableProcessApplication
  • an empty META-INF/processes.xml
  • automatic BPMN resource discovery

The same process application works correctly without the patch on Fluxnova 2.0.0, 2.0.1 and 2.0.2.

Fixes #286 in version 3.0.0. A separate PR addresses the issue for the 2.0.x release train.

@ryans58
ryans58 requested a review from a team as a code owner August 24, 2026 16:55
@ryans58 ryans58 changed the title Fix Windows Spring Boot Process Application Resource Scanningin 3.0.0 Fix Windows Spring Boot Process Application Resource Scanning in 3.0.0 Aug 24, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Backlog

Development

Successfully merging this pull request may close these issues.

Spring Boot Process Application Deployment Failures in Windows in 2.0.3, 2.0.4 and 3.0.0

2 participants