iText7+PDFSweep（C#）PDF遮罩颜色设置失效：仅首页生效后续页变黑

我之前也碰到过一模一样的坑，大概率是直接在RegexBasedCleanupStrategy上设置颜色时，多页处理的状态传递出了问题。这里给你两个落地可行的解决方案：

方案一：通过CleanupProperties全局设置遮罩颜色 #

这是最稳妥的方式，直接给所有清理操作指定全局遮罩颜色，确保所有页面的遮罩都会继承这个颜色设置：

using iText.Kernel.Colors;
using iText.PdfCleanup;

string input = SRC_FOLDER + "/report.pdf";
string output = SRC_FOLDER + "/report_redacted.pdf";

// 构建复合清理策略
CompositeCleanupStrategy strategy = new CompositeCleanupStrategy();
strategy.Add(new RegexBasedCleanupStrategy(@"(\d\d\d\d)"));

// 创建清理属性并全局设置遮罩红色
CleanupProperties cleanupProps = new CleanupProperties();
cleanupProps.SetRedactionColor(ColorConstants.RED);

// 执行PDF清理操作
PdfCleaner.CleanPdf(input, output, strategy, cleanupProps);

方案二：修复RegexBasedCleanupStrategy的颜色传递问题 #

如果你坚持要在策略本身设置颜色，首先检查你的PDFSweep版本——旧版本确实存在多页处理时颜色不保留的bug，升级到最新版的iText7和PDFSweep组件基本能解决。另外也可以尝试显式赋值的方式确保颜色生效：

var regexStrategy = new RegexBasedCleanupStrategy(@"(\d\d\d\d)");
// 直接赋值属性而非链式调用，避免状态丢失
regexStrategy.RedactionColor = ColorConstants.RED;
strategy.Add(regexStrategy);

额外排查方向 #

如果以上方案都没效果，可以检查你的PDF文件本身：

• 验证后续页面的目标文本是否真的被正则表达式匹配到（可以先打印匹配到的位置信息确认）
• 检查PDF是否有特殊结构（比如XFA表单、加密内容、嵌套页面），这类结构可能会干扰PDFSweep的处理逻辑

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