DCM4CHEE源码本地运行入门：寻求专家指导

一、前置环境二次核对 #

• 确认安装JDK 11或17（DCM4CHEE 5.x优先用JDK11，部分新分支支持17），执行 java -version 验证版本
• 确保Maven 3.6+可用，执行 mvn -v 确认配置
• 检查PostgreSQL 10+服务状态，已创建名为dcm4chee的数据库，且数据库用户拥有读写权限

二、源码构建流程 #

1. 进入克隆的代码根目录：

   cd dcm4chee-arc-light
   

2. 执行Maven构建，开发阶段可跳过测试加速：

   mvn clean install -DskipTests
   

3. 若构建失败，先处理依赖问题：

   # 重新拉取依赖
   mvn dependency:resolve
   # 强制更新本地仓库依赖后重试
   mvn clean install -U -DskipTests
   

三、本地部署启动 #

1. 数据库初始化 #

• 执行基础表结构创建脚本：

  psql -U <你的数据库用户名> -d dcm4chee -f dcm4chee-arc-psql/src/main/sql/create.sql
  

• 可选执行测试数据插入脚本（用于快速验证功能）：

  psql -U <你的数据库用户名> -d dcm4chee -f dcm4chee-arc-psql/src/main/sql/insert.sql
  

2. 启动应用服务 #

• 进入war模块目录：

  cd dcm4chee-arc-war
  

• 用Jetty插件启动，指定数据库连接信息：

  mvn jetty:run -Ddb.url=jdbc:postgresql://localhost:5432/dcm4chee -Ddb.user=<用户名> -Ddb.password=<密码>
  

• 启动成功后，访问Web控制台：http://localhost:8080/dcm4chee-arc/ui2（默认账号admin，密码admin）

四、常见问题排查建议 #

• 数据库连接失败：检查PostgreSQL是否启动，端口、账号密码是否匹配，dcm4chee数据库是否存在
• 依赖冲突：查看Maven构建日志，定位冲突依赖包，在对应模块的pom.xml中用<exclusions>标签排除重复依赖
• 端口占用：修改Jetty端口，执行 mvn jetty:run -Djetty.port=8081；DICOM服务端口冲突的话，添加启动参数 -Ddicom.port=10004
• 影像接收失败：检查本地防火墙是否开放默认DICOM端口104，或确认启动参数中指定的端口是否正确

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