bensheldon/good_job · error

WEBrick was requested as the probe server handler, but it's

Error message

WEBrick was requested as the probe server handler, but it's not in the load path. GoodJob doesn't keep WEBrick as a dependency, so you'll have to make sure its added to your Gemfile to make use of it. GoodJob will fallback to its own webserver in the meantime.

What it means

Error "WEBrick was requested as the probe server handler, but it's not in the load path. GoodJob doesn't keep WEBrick as a dependency, so you'll have to make sure its added to your Gemfile to make use of it. GoodJob will fallback to its own webserver in the meantime." thrown in bensheldon/good_job.

Source

Thrown at lib/good_job/probe_server.rb:44

      @future.execute
    end

    def running?
      @handler&.running?
    end

    def stop
      @handler&.stop
      @future&.value # wait for Future to exit
    end

    def build_handler(port:, handler:, app:)
      if handler == :webrick
        begin
          require 'webrick'
          WebrickHandler.new(app, port: port, logger: GoodJob.logger)
        rescue LoadError
          GoodJob.logger.warn("WEBrick was requested as the probe server handler, but it's not in the load path. GoodJob doesn't keep WEBrick as a dependency, so you'll have to make sure its added to your Gemfile to make use of it. GoodJob will fallback to its own webserver in the meantime.")
          SimpleHandler.new(app, port: port, logger: GoodJob.logger)
        end
      else
        SimpleHandler.new(app, port: port, logger: GoodJob.logger)
      end
    end
  end
end

View on GitHub (pinned to 5fcde48f87)

Solutions

1. Add the webrick gem to your Gemfile to use WEBrick as the probe server handler.
2. Run bundle install after adding the gem; otherwise GoodJob falls back to its own webserver.

Example fix

gem 'webrick'

When it happens

Trigger: Thrown at lib/good_job/probe_server.rb:44 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of bensheldon/good_job@5fcde48f87 (2026-08-23). Data as JSON: /api/errors/ea5a6247fcb46ce6. Report an issue: GitHub.