WSO2 IS 5.11 Docker部署用户操作通知模板路径错误求助

核心问题分析 #

1. 容器无法识别宿主机Windows本地路径 #

Docker容器是独立的文件系统环境，你在msg-mgt.properties里写的C:\Users\rocco\Documents\WSO2\docker-wso2\conf\is-as-km\repository\template.xml是宿主机的Windows路径，容器内部根本访问不到这个路径，必然触发FileNotFoundException。

2. 配置项存在换行错误 #

你的msg-mgt.properties里多个配置项被错误拆分成多行，导致配置解析异常：

• email.subscription.userOperation.template=和路径分两行
• email.subscription.userOperation.subject=和内容分两行
• email.subscription.userOperation.endpoint.privateMail.address=和邮箱地址分两行
  这种换行会让配置解析器读取到不完整的配置值，模板路径实际变成无效的空值或残缺字符串。

修复步骤 #

第一步：修正msg-mgt.properties配置格式 #

把所有换行的配置项合并成单行，同时将模板路径改为容器内部的有效路径（WSO2 IS 5.11容器内的默认配置目录为/home/wso2carbon/wso2is-5.11.0/repository/conf/），修正后的配置如下：

module.name.1=email
email.subscription.1=userOperation
email.subscription.userOperation.template=/home/wso2carbon/wso2is-5.11.0/repository/conf/template.xml
#email.subscription.userOperation.salutation=Admin
email.subscription.userOperation.subject=User operation change information
email.subscription.userOperation.endpoint.1=wso2iamtest
email.subscription.userOperation.endpoint.privateMail.address=wso2iamtest@outlook.it
#email.subscription.userOperation.endpoint.privateMail.salutation=Admin private mail
#email.subscription.userOperation.endpoint.privateMail.subject=User operation change information to private mail

第二步：挂载宿主机模板文件到容器 #

启动容器时，通过Docker挂载规则将宿主机的template.xml映射到容器内的对应路径：

• 若用docker-compose.yml：

version: '3.8'
services:
  wso2is:
    image: wso2/wso2is:5.11.0
    volumes:
      - C:\Users\rocco\Documents\WSO2\docker-wso2\conf\is-as-km\repository\template.xml:/home/wso2carbon/wso2is-5.11.0/repository/conf/template.xml
    ports:
      - "9443:9443"

• 若用docker run命令：

docker run -d -p 9443:9443 \
  -v C:\Users\rocco\Documents\WSO2\docker-wso2\conf\is-as-km\repository\template.xml:/home/wso2carbon/wso2is-5.11.0/repository/conf/template.xml \
  wso2/wso2is:5.11.0

第三步：验证挂载有效性 #

容器启动后，进入容器内部检查文件是否存在：

docker exec -it <容器ID> /bin/bash
# 进入容器后执行
ls /home/wso2carbon/wso2is-5.11.0/repository/conf/template.xml

能看到文件则说明挂载成功。

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