Issue

Pipeline load directive throws IOException instead of FileNotFoundException if file not found when run in agent.

Environment

• CloudBees CI (CloudBees Core) on modern cloud platforms - Managed controller
• CloudBees CI (CloudBees Core) on traditional platforms - Client controller
• CloudBees Jenkins Enterprise - Managed controller
• CloudBees Jenkins Platform - Client controller
• CloudBees Jenkins Distribution
• Jenkins LTS

Resolution

If using a try / catch block to determine the root cause of the exception, you need to unwrap the IOException to uncover the root cause.

Example:

node {
    try {
    load 'filethatdoesnotexist.ext'
    } catch(FileNotFoundException e) {
        // do something
    } catch(IOException e) {
        if(e.getCause() instanceof FileNotFoundException) {
            // Inner exception is FileNotFoundException
            // do something
        } else {
            // do something else
        }
    }
}

References

• Pipeline as Code in Jenkins