Hybris复合Cron Job执行时分类目录同步失败问题咨询

First, let’s ground this in your specific scenario: you’ve got a composite cron job handling multi-site data flow—global staged → global online (this part works for all languages), then global online → each site’s staged directory. The problem? Some language data is missing in the site-staged directories, and your logs throw these errors:

ERROR [CompositeCronjob::de.hybris.platform.servicelayer.internal.jalo.ServicelayerJob] (00010Z0P) [CatalogVersionSyncMaster] sync ended with 4 unfinished items - see last sync media for details
ERROR [CompositeCronjob::de.hybris.platform.servicelayer.internal.jalo.ServicelayerJob] (00010Z0P) [CatalogVersionSyncJob] Finished synchronization in 0d 00h:05m:47s:002ms. There were errors during the synchronization!

And you mentioned HMC doesn’t show additional log details—no worries, we’ve got clear paths to dig deeper. Here’s how to fix this:

• Track down the sync media file first (this is your biggest clue)
  The log explicitly mentions checking the "last sync media"—Hybris stores granular sync failure details here, even if HMC’s log viewer doesn’t display them. Do this:

  1. In Backoffice or HMC, locate the failed CatalogVersionSyncJob (or CatalogVersionSyncMaster) with ID 00010Z0P.
  2. Look for the syncMedia attribute (it’s usually under the Synchronization or Job Details section).
  3. Download this media file—it’ll list exactly which 4 items failed, which languages are missing, and the root cause (e.g., missing locale on target catalog, item-level language restrictions).

• Verify target site catalog version language settings
  It’s common for site-specific catalog versions to have a limited set of active languages, which blocks sync of unconfigured locales.

  1. Navigate to your target site’s staged catalog version (e.g., mysiteStaged) in Backoffice/HMC.
  2. Check the activeLanguages list—make sure it includes every language present in the global online catalog. If any are missing, add them and re-run the sync job.

• Audit the 4 unfinished items for data gaps or restrictions
  The sync media will give you the IDs of these items—use them to investigate:

  1. Pull up each item in the global online catalog: do they have complete data for the missing languages? If not, fix the source data first (since you can’t sync what doesn’t exist).
  2. Check for item-level restrictions: do these products/categories have site-specific visibility rules, or language filters that block sync to the target site? Remove or adjust these restrictions if they’re unintended.

• Double-check the sync job’s configuration
  Sometimes the job itself is set to skip certain languages:

  1. Open the composite cron job’s global online → site staged sync step.
  2. Ensure it’s configured to sync all languages (not a filtered subset). Look for a "languages" parameter that might be limiting the sync.
  3. Test a full sync instead of incremental: if you’ve been using incremental sync, some language data added post-full-sync might not be picked up. A full sync will force all data to be pushed to the target.

• Rule out platform bugs or extension conflicts
  If all configurations check out, it could be a platform-specific issue:

  1. Review the release notes for your Hybris version—some older versions have known bugs with multi-language sync in composite jobs.
  2. Temporarily disable any custom extensions that modify catalog sync behavior, then re-run the job. If the issue goes away, you’ve found the culprit in your custom code.

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