zmuxuny opened a new issue, #7172: URL: https://github.com/apache/rocketmq-dashboard/issues/7172
### Before Creating the Doc Report - [x] I have searched the [open issues](https://github.com/apache/rocketmq-dashboard/issues) and found no similar issue. ### Which Documentation CONTRIBUTING.md, Run the backend only, on rocketmq-studio at 127c47b06a268cc74224d5f34c56ec7c36ac0d55. ### What Is Wrong The backend-only section gives only `mvn -B -ntp spring-boot:run` (with packaging presented as an alternative), but does not describe a self-contained local-development datasource. The default application configuration is MySQL, whose driver is excluded by the Spring Boot plugin. The existing `dev` profile uses embedded H2, but H2 is test-scoped in server/pom.xml, so selecting dev alone also fails. Reproduced with JDK 21.0.12.1 and Maven 3.9.12, from server/: `mvn -o -B -ntp spring-boot:run -Dspring-boot.run.profiles=dev` fails with `Cannot load driver class: org.h2.Driver`. Adding `-Dspring-boot.run.useTestClasspath=true` starts Studio and answers `/readyz` with HTTP 200 and `{"status":"UP"}`. Verification used the cached official dependencies, a unique in-memory H2 database, loopback port 18888, an isolated environment and bounded heaps; no external database or RocketMQ cluster was contacted. The running process was stopped after the successful probe. This is documentation for the existing local dev mode, not a proposal to bundle H2 in releases or to use its ephemeral database in production. ### Suggested Change Document the existing dev profile together with `-Dspring-boot.run.useTestClasspath=true`, explain that its in-memory database is lost when the process exits, and point persistent/MySQL users to the existing full-stack deployment instructions. Show the normal backend port/readiness URL, and separate `mvn package` (build only) from running the backend. No dependency scopes, runtime code or packaging changes. The Spring Boot Maven plugin documents both properties: https://docs.spring.io/spring-boot/maven-plugin/run.html . Searches for useTestClasspath, spring-boot:run/dev, and the backend-only/H2 instructions found no matching issue. AI assistance was used to investigate and verify this report. ### Are You Willing to Submit a Pull Request? - [x] Yes, I am willing to submit a pull request. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
