CORB导出含特殊字符文件名失败问题求助

报错显示SVC-FILOPN: xdmp:save(...) -- File open error，核心原因是文件名中包含?、/等操作系统文件系统的保留字符：

• /会被系统识别为目录分隔符，导致试图打开不存在的子目录
• ?是通配符，系统无法正确解析为文件名的一部分

解决方案1：批量替换非法字符为合法字符 #

在CORB的处理逻辑（PROCESSMODULE）中，先对要导出的文件名进行清洗，替换所有系统不允许的字符（如<>:\"/\\|?*）为下划线_或其他安全字符。

示例XQuery代码：

declare variable $URI as xs:string external;

let $doc := fn:doc($URI)
let $filename := fn:replace(fn:base-uri($doc), '[<>:"/\\|?*]', '_')
let $save-path := "/output/XML/" || $filename
return xdmp:save($save-path, $doc)

关键说明： #

• 正则表达式[<>:"/\\|?*]覆盖了Windows和绝大多数Unix系统的文件名非法字符
• 替换为下划线_可保证文件名可读性，同时避免冲突

解决方案2：保留路径结构并自动创建目录 #

如果需要保留原文档URI的路径层级（如travelers子目录），需先处理路径中的非法字符，再自动创建不存在的父目录：

示例XQuery代码：

declare variable $URI as xs:string external;

let $doc := fn:doc($URI)
let $path-parts := fn:tokenize($URI, "/")[position() gt 2] (: 跳过根和顶级目录（如/documents/） :)
let $cleaned-parts := fn:for-each($path-parts, function($part) {
  fn:replace($part, '[<>:"/\\|?*]', '_')
})
let $full-save-path := "/output/XML/" || fn:string-join($cleaned-parts, "/")
let $parent-dir := fn:substring($full-save-path, 1, fn:string-length($full-save-path) - fn:string-length(fn:base-name($full-save-path)) - 1)

return
  (: 自动创建父目录（如果不存在） :)
  if (not(xdmp:directory-exists($parent-dir))) then
    xdmp:directory-create($parent-dir)
  else (),
  xdmp:save($full-save-path, $doc)

解决方案3：URL编码保留原字符信息 #

如果需要完整保留原文件名的字符信息（牺牲可读性），可使用URL编码：

示例XQuery代码：

declare variable $URI as xs:string external;

let $doc := fn:doc($URI)
let $encoded-filename := xdmp:url-encode(fn:base-uri($doc))
let $save-path := "/output/XML/" || $encoded-filename
return xdmp:save($save-path, $doc)

编码后文件名会变成C19A%3FM-N%2FA.xml，系统可正常识别，后续可通过URL解码还原原文件名。

额外注意事项 #

• 确保处理后的文件名唯一：若多个原URI清洗后生成相同文件名，可在文件名后追加UUID或文档的哈希值避免覆盖
• CORB配置：将上述处理逻辑写入PROCESSMODULE，并在CORB配置文件中指定该模块路径

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