Angular SPA对接Domino Data Service：富文本字段UTF-8字符集设置问题

我之前在做Angular SPA对接Domino Data Service时，也碰到过富文本转HTML后字符集不生效的问题，结合踩过的坑，给你几个可行的排查和解决方向：

• 检查Domino服务器的全局Web配置
  打开Domino服务器的domino.conf文件（通常位于data/domino/html目录下），查找AddDefaultCharset配置项，确保它被设置为UTF-8。如果没有这个配置，直接添加一行：

  AddDefaultCharset UTF-8
  

  另外，还可以添加SetEnv LC_ALL en_US.UTF-8来强制服务端用UTF-8编码处理所有响应内容，修改后记得重启Domino服务器生效。

• 在Angular请求中显式指定编码要求
  调用Domino Data Service的API时，在请求头里明确声明你期望的字符集，避免服务端使用默认编码返回。在Angular的HttpClient中可以这么配置：

  import { HttpClient, HttpHeaders } from '@angular/common/http';
  
  // ...
  
  const headers = new HttpHeaders({
    'Accept': 'text/html; charset=utf-8',
    'Content-Type': 'application/json; charset=utf-8' // 针对POST/PUT请求
  });
  
  this.http.get('/your-domino-api-endpoint', { headers }).subscribe(response => {
    // 处理富文本HTML内容
  });
  

• 验证Notes文档富文本字段的存储编码
  有时候问题根源在文档本身的存储上：

  1. 在Notes客户端打开目标文档，右键富文本字段选择「属性」
  2. 切换到「存储」标签页，确认「Unicode」选项已勾选
  3. 如果是旧文档，尝试重新保存一次，让Domino将字段内容转换为UTF-8编码存储

• 检查Domino服务器文档的国际配置
  登录Domino管理控制台，找到对应服务器的「服务器文档」：

  1. 切换到「国际」标签页
  2. 确保「默认字符集」设置为UTF-8，且「启用Unicode」选项已勾选
  3. 同时检查服务器操作系统的区域设置（比如Linux的LANG环境变量、Windows的区域语言设置），确保系统默认编码也是UTF-8

• 用代理/XPage强制设置响应头
  如果以上方法都无效，可以用Domino的XPage或代理来包装富文本请求，手动指定响应的字符集。比如在XPage中用Java代码处理：

  import javax.faces.context.FacesContext;
  
  // ...
  
  FacesContext fc = FacesContext.getCurrentInstance();
  fc.getExternalContext().setResponseContentType("text/html");
  fc.getExternalContext().setResponseCharacterEncoding("UTF-8");
  // 输出富文本转换后的HTML内容
  fc.getExternalContext().getResponseOutputWriter().write(richTextHtmlContent);
  fc.responseComplete();
  

  然后让Angular请求这个XPage接口，就能确保返回的HTML是UTF-8编码了。

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