Rundeck UI新建项目未在服务器项目路径显示 寻求修复方案

适配环境：WAR包部署、macOS运行环境

• 优先确认项目存储类型配置
  4.x版本Rundeck默认项目存储类型为数据库存储，该模式下所有项目元数据持久化在数据库中，不会在本地文件系统生成项目目录，属于正常机制。
  若需要本地文件系统生成项目目录，修改rundeck-config.properties配置文件中以下参数：

  # 指定存储类型为文件系统
  rundeck.projectsStorageType=filesystem
  # 指定本地项目存储的绝对路径，不要用相对路径
  rundeck.projectsDir=/Users/你的用户名/rundeck/projects
  

  修改完成后重启Rundeck进程再测试新建项目。
• 排查路径权限与macOS系统限制
  1. 确认启动Rundeck的系统用户对上述配置的项目存储路径有读写、执行权限，执行以下命令校验和修复：

  # 查看路径权限，替换为你实际配置的项目路径
  ls -ld /Users/你的用户名/rundeck/projects
  # 权限不匹配时执行授权，替换为实际启动Rundeck的用户名
  chown -R 你的用户名:staff /Users/你的用户名/rundeck/projects
  chmod -R 755 /Users/你的用户名/rundeck/projects
  

  2. 若项目存储路径放在桌面、文稿、下载这类受macOS SIP保护的目录，需要打开「系统设置>隐私与安全性>完全磁盘访问」，给运行Rundeck的Java程序勾选授权，否则进程无权限写入目录，会导致目录生成失败。
• 校验启动时配置加载是否正确
  WAR包直接启动时如果没有显式指定外置配置文件路径，会默认加载WAR包内置的配置，你修改的本地配置不会生效。启动时通过参数显式指定配置路径即可：

  java -jar rundeck-4.1.0-20220420.war --rundeck.config.file=/Users/你的用户名/rundeck/config/rundeck-config.properties
  

  启动时查看控制台日志，搜索projectsDir关键字，确认日志打印的项目存储路径和你配置的路径完全一致，不存在配置加载错位问题。
• 结果校验
  若使用数据库存储模式，新建项目后直接查询Rundeck对应数据库的project表，即可看到新建项目的记录，无需查找本地目录；若切换为文件系统存储模式，新建项目后刷新配置的项目存储路径，即可看到以项目名命名的目录，目录下默认包含etc/project.properties等项目核心配置文件。

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