本地部署Apache Fineract时API请求出现404资源未找到错误

• 修正API请求路径：你的请求URL里重复了v1，正确路径应为：

  GET http://localhost:8443/fineract-provider/api/v1/glclosures?officeId=123
  

  先尝试用修正后的路径发起请求，排除路径拼写错误的问题。

• 完成数据库初始化：仅创建数据库是空的，需要执行Flyway脚本初始化schema和基础数据：

  ./gradlew flywayMigrate -PdbName=fineract_tenants
  ./gradlew flywayMigrate -PdbName=fineract_default
  

  执行完成后重启应用，确保应用能读取到数据库中的租户和业务数据。

• 检查启动日志：启动应用后查看日志，确认是否有Spring MVC的映射日志，比如类似：

  Mapped "{[/api/v1/glclosures],methods=[GET]}" onto public ...
  

  如果没有此类日志，说明控制器类未被Spring扫描到，需要检查启动类ServerApplication的包扫描范围是否覆盖了API控制器所在的包（默认应为org.apache.fineract）。

• 验证数据库连接配置：检查application.properties（或application.yml）中的数据库连接参数是否正确：

  spring.datasource.url=jdbc:mariadb://localhost:3306/fineract_default?useSSL=false&serverTimezone=UTC
  spring.datasource.username=root
  spring.datasource.password=mysql
  

  确保应用能正常连接到MariaDB，数据库连接失败会导致API无法完成初始化。

• 重新构建项目：执行完整的Gradle构建，排除编译或打包问题：

  ./gradlew clean build -x test
  

  构建完成后重新启动应用，确保所有模块都正确编译并加载。

内容的提问来源于stack exchange，提问作者rajeevbk