如何将静态HTML文件作为组件插入基于指定模板创建的AEM页面？

刚好做过类似的需求，我来给你一步步拆解怎么实现把静态HTML填充到AEM页面的空白内容区域：

AEM不能直接把静态HTML文件“插入”成组件，得先有一个能承载并渲染HTML内容的组件。有两种常见方式：

方式A：自定义一个静态HTML组件 #

在你的项目代码库的apps/[你的项目名]/components/content目录下新建一个组件（比如叫static-html），核心是写好HTL脚本和对应的模型：

• HTL脚本（static-html.html）：直接输出HTML内容，注意要关闭AEM的HTML转义（生产环境要确保内容安全）

<div data-sly-use.model="com.你的项目名.models.StaticHtmlModel">
    ${model.htmlContent @ context='unsafe'}
</div>

• Java模型（StaticHtmlModel.java）：从JCR节点读取存储的HTML内容

import org.apache.sling.api.resource.Resource;
import org.apache.sling.models.annotations.Model;
import org.apache.sling.models.annotations.injectorspecific.ValueMapValue;

@Model(adaptables = Resource.class)
public class StaticHtmlModel {
    @ValueMapValue
    private String htmlContent;

    public String getHtmlContent() {
        return htmlContent;
    }
}

方式B：用AEM自带的Text组件（简化版） #

如果不想自定义组件，可以用AEM默认的Text组件，但需要配置它允许所有HTML标签：

• 找到Text组件的编辑配置（在模板或组件策略里），开启“允许HTML”选项，或者调整htmlPolicy允许所需的标签。

这部分你已经有基础，直接给你示例代码：

// 获取PageManager实例
PageManager pageManager = resourceResolver.adaptTo(PageManager.class);
// 模板路径替换成你实际的模板路径
String templatePath = "/conf/你的项目名/settings/wcm/templates/你的模板名";
// 创建页面：父路径、页面名称、模板路径、页面标题
Page newPage = pageManager.create("/content/你的项目名/en", "my-new-page", templatePath, "我的静态HTML页面");

接下来要找到模板里的空白内容容器（一般是parsys或iparsys组件），然后在里面添加我们的组件并填充HTML内容：

步骤A：读取静态HTML文件的内容 #

假设你的HTML文件放在项目的资源目录里，或者已经上传到AEM DAM，这里以读取类路径下的文件为例：

// 读取HTML文件内容
String htmlContent = new String(Files.readAllBytes(Paths.get(
    getClass().getResource("/static-files/my-content.html").toURI()
)));

步骤B：找到内容区域并添加组件节点 #

找到页面中空白内容区域的JCR节点，然后创建我们的组件节点并写入HTML：

// 获取页面的内容资源，替换成你模板中空白区域的实际路径（比如root/container/parsys）
Resource parsysResource = newPage.getContentResource().getChild("root/container/parsys");
Node parsysNode = parsysResource.adaptTo(Node.class);

// 在parsys下创建static-html组件节点
Node htmlComponentNode = JcrUtils.addNode(parsysNode, "static-html-item", "cq:Component");
// 指定组件的resourceType
htmlComponentNode.setProperty("sling:resourceType", "你的项目名/components/content/static-html");
// 把HTML内容存入节点属性
htmlComponentNode.setProperty("htmlContent", htmlContent);

// 提交会话，保存更改
resourceResolver.commit();

• XSS安全：如果HTML内容来自用户上传，一定要用AEM的XSSAPI做过滤，不要直接用context='unsafe'，避免注入风险。
• 权限问题：确保你的resourceResolver拥有创建页面、修改JCR节点的权限（比如wcm:write、jcr:modifyProperties）。
• 路径准确性：模板中空白内容区域的路径（比如root/container/parsys）要和你实际模板的结构一致，可以通过CRXDE查看模板的JCR结构确认。

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