CloudFront后部署Confluence触发java.lang.IllegalArgumentException报错的配置咨询

这个错误我之前帮团队排查过，本质是Confluence收到的请求URL格式不符合预期，根源是请求路径里出现了多余的斜杠（比如//）——和Nginx场景的问题原因完全一致，但CloudFront确实没有像Nginx那样直接移除尾部斜杠的配置项，不过我们可以用以下两种方式解决：

1. 先检查基础配置是否有疏漏 #

• 确认CloudFront源站地址：登录CloudFront控制台，进入对应分发的源站（Origin）设置，检查Origin Domain Name的取值，确保没有尾部斜杠。比如填your-confluence-origin.com而不是your-confluence-origin.com/——虽然CloudFront会自动处理部分格式问题，但自定义源站的路径配置偶尔会残留斜杠，先把这里修正。
• 检查Confluence的Server Base URL：登录Confluence后台，找到「General Configuration」里的「Server Base URL」，确保它和CloudFront的访问域名完全一致，且没有尾部斜杠（比如https://your-cloudfront-domain.com）。这个配置如果带了斜杠，会导致Confluence生成错误的内部链接，间接触发这个异常。

2. 用Lambda@Edge修正请求路径 #

如果基础配置没问题，就需要通过Lambda@Edge在请求到达Confluence源站之前，主动修正URL路径：

• 创建一个Lambda函数（注意必须选择us-east-1区域，因为Lambda@Edge要求部署在这个区域），代码如下：

exports.handler = async (event) => {
    const request = event.Records[0].cf.request;
    let uri = request.uri;

    // 移除路径末尾的多余斜杠，同时处理"//"的特殊情况
    uri = uri.replace(/\/+$/, '/');
    if (uri === '//') {
        uri = '/';
    }

    request.uri = uri;
    return request;
};

• 把这个函数部署到CloudFront的Origin Request阶段（这样修改后的请求会直接发送给源站），并关联到对应的缓存行为上。

这个函数会自动把请求路径里的多余斜杠（比如//或者path//）修正为正常的单斜杠，从根源上解决Confluence收到错误URI的问题。我当时就是用这个方法搞定了团队的相同问题，你可以先试基础配置检查，不行再上Lambda@Edge的方案。

内容的提问来源于stack exchange，提问作者shonky linux user