Setting an non-existent Macro Library breaks the FreeMarker engine and makes the portal inaccessible

• Type: Bug
• Status: Closed
• Resolution: Fixed
• Affects Version/s: 7.2.X, 7.3.X, Master
• Fix Version/s: 7.2.10 DXP FP17, 7.2.10.6 DXP SP6, 7.2.X, 7.3.10.3 DXP SP3, 7.3.X, 7.4.3.5 CE GA5, 7.4.13 DXP U1, Master
• Component/s: Core Infrastructure > Freemarker OSGi Bridge
• Labels:
  • ee-ts
  • liferay-dxp-72-sp6
  • liferay-dxp-73-sp3
  • liferay-fix-pack-dxp-3-7310
  • liferay-fixpack-dxp-17-7210
  • liferay-fixpack-dxp-3-7310
  • liferay-update-dxp-1-7413
• Branch Version/s:
  7.3.x, 7.2.x
• Backported to Branch:
  Committed
• Fix Priority: 4
• Git Pull Request: https://github.com/brianchandotcom/liferay-portal/pull/108962

Steps to reproduce:

1. Sign In as admin.
2. Go to Control Panel > System settings > Templates engines
3. Add a new entry for Macro Library, clicking on
4. For the new entry, set the value: FTL_test.ftl as test1
5. Try to navigate to any other page in the portal

Observed behavior: The portal is unaccessible (blank pages with a generic error message: An unexpected system error occurred. ). And error in the log file:

2021-10-19 10:03:37.441 ERROR [http-nio-8080-exec-8][IncludeTag:128] Current URL /group/control_panel/manage?p_p_id=com_liferay_configuration_admin_web_portlet_SystemSettingsPortlet&p_p_lifecycle=0&p_p_state=maximized&p_p_mode=view&_com_liferay_configuration_admin_web_portlet_SystemSettingsPortlet_factoryPid=com.liferay.portal.template.freemarker.configuration.FreeMarkerEngineConfiguration&_com_liferay_configuration_admin_web_portlet_SystemSettingsPortlet_mvcRenderCommandName=%2Fconfiguration_admin%2Fedit_configuration&_com_liferay_configuration_admin_web_portlet_SystemSettingsPortlet_pid=com.liferay.portal.template.freemarker.configuration.FreeMarkerEngineConfiguration generates exception: com.liferay.portal.kernel.templateparser.TransformException: Unhandled exception
java.io.IOException: Unable to find FreeMarker template with ID com.liferay.portal.template.freemarker_7.0.13_CLASS_LOADER_CONTEXT_FTL_test.ftl
	at com.liferay.portal.template.freemarker.internal.LiferayTemplateCache.getTemplate(LiferayTemplateCache.java:100) ~[?:?]
	at freemarker.template.Configuration.getTemplate(Configuration.java:2798) ~[?:?]
	at freemarker.core.Environment.getTemplateForInclusion(Environment.java:2652) ~[?:?]
	at freemarker.core.Environment.getTemplateForInclusion(Environment.java:2614) ~[?:?]
	at freemarker.core.Environment.getTemplateForImporting(Environment.java:2776) ~[?:?]
	at freemarker.core.Environment.importLib(Environment.java:2761) ~[?:?]
	at freemarker.template.Configuration.doAutoImports(Configuration.java:3511) ~[?:?]
	at freemarker.template.Configuration.doAutoImportsAndIncludes(Configuration.java:3496) ~[?:?]
	at freemarker.core.Configurable.doAutoImportsAndIncludes(Configurable.java:3149) ~[?:?]
	at freemarker.core.Configurable.doAutoImportsAndIncludes(Configurable.java:3149) ~[?:?]
	at freemarker.core.Environment.process(Environment.java:309) ~[?:?]
	at freemarker.template.Template.process(Template.java:383) ~[?:?]
	at com.liferay.portal.template.freemarker.internal.FreeMarkerTemplate.lambda$processTemplate$0(FreeMarkerTemplate.java:157) ~[?:?]
	at com.liferay.portal.template.freemarker.internal.FreeMarkerManager.render(FreeMarkerManager.java:524) ~[?:?]
	at com.liferay.portal.template.freemarker.internal.FreeMarkerTemplate.processTemplate(FreeMarkerTemplate.java:144) ~[?:?]
	at com.liferay.portal.template.BaseTemplate.processTemplate(BaseTemplate.java:168) ~[portal-impl.jar:?]
	at com.liferay.portal.templateparser.Transformer.transform(Transformer.java:151) ~[portal-impl.jar:?]
	at com.liferay.portlet.display.template.internal.PortletDisplayTemplateImpl.renderDDMTemplate(PortletDisplayTemplateImpl.java:463) ~[?:?]
	at com.liferay.portlet.display.template.internal.PortletDisplayTemplateImpl.renderDDMTemplate(PortletDisplayTemplateImpl.java:493) ~[?:?]
	at com.liferay.portlet.display.template.internal.PortletDisplayTemplateManagerImpl.renderDDMTemplate(PortletDisplayTemplateManagerImpl.java:95) ~[?:?]

Expected behavior: At least you are able use the portal.