paascloud/paascloud-master · error · OmcBizException

OMC10031013

OMC10031013

Error message

OMC10031013

What it means

ErrorCodeEnum.OMC10031013 ('failed to get attachment URL', 获取附件地址失败) is thrown by OpcOssServiceImpl.getFileUrl when the opc-oss Feign call getFileUrl returns null or an error Wrapper. It indicates the remote OSS service could not produce a signed/accessible URL for the requested file.

Solutions

1. Confirm the optGetUrlRequest file key/bucket matches what uploadFile actually stored
2. Check opc-oss service availability and its logs for the underlying OSS SDK error
3. Validate OSS credentials/bucket configuration in the opc-oss provider's environment

Example fix

// before
Wrapper<String> wrapper = opcOssFeignApi.getFileUrl(optGetUrlRequest);
if (null == wrapper || wrapper.error()) {
    throw new OmcBizException(ErrorCodeEnum.OMC10031013);
}
// after
Wrapper<String> wrapper = opcOssFeignApi.getFileUrl(optGetUrlRequest);
if (null == wrapper || wrapper.error()) {
    log.error("getFileUrl failed for key={}", optGetUrlRequest.getKey());
    return null; // or throw with detail
}

if (optGetUrlRequest == null || Strings.isNullOrEmpty(optGetUrlRequest.getKey())) {
    throw new IllegalArgumentException("file key required");
}

try {
    String url = opcOssService.getFileUrl(optGetUrlRequest);
} catch (OmcBizException e) {
    if (e.getCode() == 10031013) { url = fallbackUrl(optGetUrlRequest); }
    else throw e;
}

When it happens

Trigger: Calling getFileUrl(optGetUrlRequest) when the opc-oss service is unavailable (null wrapper from fallback), or the OSS service errors resolving the file key/bucket (nonexistent file key, expired/invalid credentials).

Common situations: Requesting a URL for a file that was never uploaded or already removed from the bucket, opc-oss service down, misconfigured bucket/endpoint after an environment migration.

Related errors

• OMC10031012
• GL99990002
• GL99990002
• GL99990002
• GL99990002

AI-assisted analysis of paascloud/paascloud-master@781281a950 (2026-09-10). Data as JSON: /api/errors/8c71d71086664692. Report an issue: GitHub.

Appendix: source

Thrown at paascloud-provider/paascloud-provider-omc/src/main/java/com/paascloud/provider/service/impl/OpcOssServiceImpl.java:53

	@Resource
	private OpcOssFeignApi opcOssFeignApi;

	@Override
	public OptUploadFileRespDto uploadFile(OptUploadFileReqDto optUploadFileReqDto) {
		log.info("uploadFile - 上传附件. optUploadFileReqDto={}", optUploadFileReqDto);
		Wrapper<OptUploadFileRespDto> wrapper = opcOssFeignApi.uploadFile(optUploadFileReqDto);
		if (null == wrapper || wrapper.error()) {
			throw new OmcBizException(ErrorCodeEnum.OMC10031012);
		}
		return wrapper.getResult();
	}

	@Override
	public String getFileUrl(OptGetUrlRequest optGetUrlRequest) {
		log.info("getFileUrl - 获取附件地址. optUploadFileReqDto={}", optGetUrlRequest);
		Wrapper<String> wrapper = opcOssFeignApi.getFileUrl(optGetUrlRequest);
		if (null == wrapper || wrapper.error()) {
			throw new OmcBizException(ErrorCodeEnum.OMC10031013);
		}
		return wrapper.getResult();
	}
}

View on GitHub (pinned to 781281a950)