ServiceNow附件不显示求助：API上传附件仅活动区可见

我之前帮好几个开发者解决过一模一样的问题，核心原因通常是附件关联的对象不对，或者API请求参数有疏漏。下面给你一步步排查和解决的方法：

1. 优先检查table_sys_id参数是否正确 #

这是最常见的坑：你可能误把事件单的活动日志记录ID当成了事件单本身的ID传给了API。

• 正确的table_sys_id是事件单页面URL里的那个ID，比如打开事件单后，URL是https://xyz.service-now.com/incident.do?sys_id=abc123xyz...，这里的abc123xyz就是你要传的table_sys_id。
• 如果传成了活动日志（sys_journal_field表）的ID，附件就会挂在这条活动记录上，自然只会在活动区域显示，不会出现在「管理附件」列表里。

你可以去sys_attachment系统表中查询你上传的附件记录，看它的table_name字段是incident还是sys_journal_field——如果是后者，就说明参数传错了。

2. 确认API请求的格式和参数完整度 #

ServiceNow的/api/now/attachment/file端点要求用multipart/form-data格式上传，确保你的请求满足以下要求：

• 请求方法是POST
• 请求头包含Content-Type: multipart/form-data
• 表单参数必须包含：
  • table_name: 固定为incident
  • table_sys_id: 事件单的正确ID
  • file: 要上传的本地文件（作为表单文件字段）

用Rest API Explorer测试时，直接在Form Data区域填写这三个参数，不要手动拼接请求体，避免格式错误。

3. 排查权限和系统规则问题 #

如果参数和格式都没问题，那可能是权限或自定义规则导致的：

• 检查你的API用户是否拥有incident_attachment_write权限，没有的话无法将附件关联到事件单的主附件列表。
• 查看系统是否有自定义的业务规则、客户端脚本或UI策略，隐藏了「管理附件」区域的附件，或者在附件上传后修改了它的关联属性。可以去系统日志 > 应用日志里搜索相关的错误或规则执行记录。
• 用管理员账号重新测试上传，如果管理员能看到附件，那就是普通用户的权限问题。

4. 尝试替换API端点测试 #

如果以上都无效，可以试试用/api/now/attachment端点（不带/file后缀）上传，步骤如下：

• 发送POST请求到/api/now/attachment
• 请求头设置Content-Type: multipart/form-data
• 表单参数包含：
  • table_name: incident
  • table_sys_id: 事件单ID
  • file_name: 你的文件名（比如test.pdf）
  • file: 上传的文件内容

这个端点的上传逻辑和/attachment/file略有不同，有时候能绕过一些实例的自定义限制。

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