Jira Server/Data Center: Viewing issues broken in 18.5

Summary

After migrating to Jira Cloud's new /rest/api/3/search/jql endpoint in !206815 (merged) (GitLab 18.5), the Jira issues integration no longer works for customers using Jira Server or Jira Data Center. The new endpoint and token-based pagination only exist on Jira Cloud.

We need to add a mechanism to use the older /rest/api/2/search endpoint along with offset pagination for Jira Server and Jira Data Server.

Feature breakdown

When using Jira Server or Jira Data Center with the Jira issues integration:

• ✅ GitLab can still add web links and comments to Jira issues when a Jira issue ID is mentioned (this is the main function of the integration)
• ✅ GitLab will still cross link Jira issues
• ❌ You won't be able to view Jira issues in GitLab
• ✅ GitLab can still create Jira issues from vulnerabilities
• ❌ GitLab won't be able to show the Jira issue that was created from a GitLab vulnerability

Steps to reproduce

1. Configure the Jira issues integration with a Jira Server or Jira Data Center instance
2. Try to view Jira issues in GitLab (e.g., navigate to a project's Jira issues list)
3. OR create a Jira issue from a vulnerability and try to view it in GitLab

Example Project

N/A - affects any project with Jira Server/Data Center integration configured

What is the current bug behavior?

• Users cannot view Jira issues in GitLab
• Users cannot view Jira issues related to vulnerabilities in GitLab

What is the expected correct behavior?

• Users can view Jira issues in GitLab
• Users can view Jira issues related to vulnerabilities in GitLab

Relevant logs and/or screenshots

The following logs/screenshots were tested with both Jira Data Center version 10 and 11.

User action	Error shown	Screenshot
Users cannot view Jira issues in GitLab	An error occurred while loading issues
Users cannot view Jira issues related to vulnerabilities in GitLab	Something went wrong while trying to fetch related Jira issues. Please check the Jira integration settings and try again.

The production_json.log file will show a 500 error:

{
  "meta.caller_id":"Projects::Integrations::Jira::IssuesController#index",
  "exception.class":"NoMethodError",
  "exception.message":"undefined method `map' for an instance of String",
}

Full trace from production_json.log

{"method":"GET","path":"/gitlab-org/gitlab-shell/-/integrations/jira/issues.json","format":"json","controller":"Projects::Integrations::Jira::IssuesController","action":"index","status":500,"unpermitted_params":["with_labels_details","per_page","sort","state","project_id","format","with_labels_details","state","namespace_id","project_id","format","with_labels_details","sort","namespace_id","project_id","format"],"time":"2025-10-08T21:59:16.834Z","params":[{"key":"with_labels_details","value":"true"},{"key":"per_page","value":"20"},{"key":"sort","value":"created_desc"},{"key":"state","value":"opened"},{"key":"namespace_id","value":"gitlab-org"},{"key":"project_id","value":"gitlab-shell"}],"correlation_id":"01K72XBVYY2143FR3F4FGJ8M9S","meta.caller_id":"Projects::Integrations::Jira::IssuesController#index","meta.feature_category":"integrations","meta.organization_id":1,"meta.remote_ip":"127.0.0.1","meta.user":"root","meta.user_id":1,"meta.project":"gitlab-org/gitlab-shell","meta.root_namespace":"gitlab-org","meta.client_id":"user/1","remote_ip":"127.0.0.1","user_id":1,"username":"root","ua":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/141.0.0.0 Safari/537.36","queue_duration_s":0.046541,"request_urgency":"default","target_duration_s":1,"db_count":15,"db_write_count":0,"db_cached_count":2,"db_txn_count":0,"db_replica_txn_count":0,"db_primary_txn_count":0,"db_replica_count":0,"db_primary_count":15,"db_replica_write_count":0,"db_primary_write_count":0,"db_replica_cached_count":0,"db_primary_cached_count":2,"db_replica_wal_count":0,"db_primary_wal_count":0,"db_replica_wal_cached_count":0,"db_primary_wal_cached_count":0,"db_replica_txn_max_duration_s":0.0,"db_primary_txn_max_duration_s":0.0,"db_replica_txn_duration_s":0.0,"db_primary_txn_duration_s":0.0,"db_replica_duration_s":0.0,"db_primary_duration_s":0.032,"db_main_txn_count":0,"db_ci_txn_count":0,"db_main_replica_txn_count":0,"db_ci_replica_txn_count":0,"db_main_count":15,"db_ci_count":0,"db_main_replica_count":0,"db_ci_replica_count":0,"db_main_write_count":0,"db_ci_write_count":0,"db_main_replica_write_count":0,"db_ci_replica_write_count":0,"db_main_cached_count":2,"db_ci_cached_count":0,"db_main_replica_cached_count":0,"db_ci_replica_cached_count":0,"db_main_wal_count":0,"db_ci_wal_count":0,"db_main_replica_wal_count":0,"db_ci_replica_wal_count":0,"db_main_wal_cached_count":0,"db_ci_wal_cached_count":0,"db_main_replica_wal_cached_count":0,"db_ci_replica_wal_cached_count":0,"db_main_txn_max_duration_s":0.0,"db_ci_txn_max_duration_s":0.0,"db_main_replica_txn_max_duration_s":0.0,"db_ci_replica_txn_max_duration_s":0.0,"db_main_txn_duration_s":0.0,"db_ci_txn_duration_s":0.0,"db_main_replica_txn_duration_s":0.0,"db_ci_replica_txn_duration_s":0.0,"db_main_duration_s":0.032,"db_ci_duration_s":0.0,"db_main_replica_duration_s":0.0,"db_ci_replica_duration_s":0.0,"external_http_count":2,"external_http_duration_s":0.2895800000987947,"path_traversal_check_duration_s":0.001421,"cpu_s":0.096274,"pid":45693,"worker_id":"puma_0","rate_limiting_gates":[],"exception.class":"NoMethodError","exception.message":"undefined method `map' for an instance of String","exception.backtrace":["ee/app/services/jira/requests/issues/list_service.rb:54:in `map_issues'","ee/app/services/jira/requests/issues/list_service.rb:47:in `build_service_response'","app/services/jira/requests/base.rb:57:in `request'","app/services/jira/requests/base.rb:30:in `execute'","ee/app/finders/projects/integrations/jira/issues_finder.rb:55:in `fetch_issues'","ee/app/finders/projects/integrations/jira/issues_finder.rb:43:in `execute'","ee/app/controllers/projects/integrations/jira/issues_controller.rb:55:in `issues_json'","ee/app/controllers/projects/integrations/jira/issues_controller.rb:30:in `block (2 levels) in index'","ee/app/controllers/projects/integrations/jira/issues_controller.rb:27:in `index'","app/controllers/application_controller.rb:488:in `set_current_admin'","lib/gitlab/session.rb:11:in `with_session'","app/controllers/application_controller.rb:479:in `set_session_storage'","lib/gitlab/i18n.rb:116:in `with_locale'","lib/gitlab/i18n.rb:122:in `with_user_locale'","app/controllers/application_controller.rb:470:in `set_locale'","app/controllers/application_controller.rb:459:in `set_current_context'","lib/gitlab/ip_address_state.rb:11:in `with'","app/controllers/application_controller.rb:465:in `set_current_ip_address'","lib/gitlab/middleware/action_controller_static_context.rb:23:in `call'","config/initializers/action_dispatch_journey_router.rb:52:in `block in find_routes'","config/initializers/action_dispatch_journey_router.rb:25:in `map!'","config/initializers/action_dispatch_journey_router.rb:25:in `find_routes'","ee/lib/omni_auth/strategies/group_saml.rb:41:in `other_phase'","lib/gitlab/metrics/elasticsearch_rack_middleware.rb:16:in `call'","lib/gitlab/middleware/sidekiq_shard_awareness_validation.rb:20:in `block in call'","lib/gitlab/sidekiq_sharding/validator.rb:42:in `enabled'","lib/gitlab/middleware/sidekiq_shard_awareness_validation.rb:20:in `call'","lib/gitlab/middleware/memory_report.rb:13:in `call'","lib/gitlab/middleware/speedscope.rb:13:in `call'","lib/gitlab/query_limiting/middleware.rb:19:in `block in call'","lib/gitlab/query_limiting/transaction.rb:48:in `run'","lib/gitlab/query_limiting/middleware.rb:18:in `call'","lib/gitlab/middleware/rails_queue_duration.rb:33:in `call'","lib/gitlab/etag_caching/middleware.rb:21:in `call'","lib/gitlab/metrics/rack_middleware.rb:16:in `block in call'","lib/gitlab/metrics/web_transaction.rb:46:in `run'","lib/gitlab/metrics/rack_middleware.rb:16:in `call'","lib/gitlab/middleware/go.rb:21:in `call'","lib/gitlab/middleware/query_analyzer.rb:11:in `block in call'","lib/gitlab/database/query_analyzer.rb:83:in `within'","lib/gitlab/middleware/query_analyzer.rb:11:in `call'","lib/ci/job_token/middleware.rb:11:in `call'","lib/gitlab/middleware/multipart.rb:174:in `call'","lib/gitlab/middleware/read_only/controller.rb:40:in `call'","lib/gitlab/middleware/read_only.rb:18:in `call'","lib/gitlab/middleware/unauthenticated_session_expiry.rb:18:in `call'","lib/gitlab/middleware/secure_headers.rb:11:in `call'","lib/gitlab/middleware/strip_cookies.rb:29:in `call'","lib/gitlab/middleware/same_site_cookies.rb:27:in `call'","lib/gitlab/middleware/path_traversal_check.rb:40:in `call'","lib/gitlab/middleware/handle_malformed_strings.rb:19:in `call'","lib/gitlab/middleware/json_validation.rb:153:in `call'","lib/gitlab/middleware/basic_health_check.rb:25:in `call'","lib/gitlab/middleware/handle_ip_spoof_attack_error.rb:25:in `call'","lib/gitlab/middleware/request_context.rb:15:in `call'","lib/gitlab/middleware/webhook_recursion_detection.rb:15:in `call'","config/initializers/fix_local_cache_middleware.rb:11:in `call'","lib/gitlab/middleware/compressed_json.rb:44:in `call'","lib/gitlab/middleware/static.rb:11:in `call'","lib/gitlab/middleware/rack_multipart_tempfile_factory.rb:19:in `call'","lib/gitlab/middleware/sidekiq_web_static.rb:20:in `call'","lib/gitlab/metrics/requests_rack_middleware.rb:83:in `call'","lib/gitlab/middleware/release_env.rb:12:in `call'"],"db_duration_s":0.02983,"view_duration_s":0.0,"duration_s":0.58171}

Output of checks

Results of GitLab environment info

Expand for output related to GitLab environment info

(For installations with omnibus-gitlab package run and paste the output of:
`sudo gitlab-rake gitlab:env:info`)

(For installations from source run and paste the output of:
`sudo -u git -H bundle exec rake gitlab:env:info RAILS_ENV=production`)

Results of GitLab application Check

Expand for output related to the GitLab application check

(For installations with omnibus-gitlab package run and paste the output of:
sudo gitlab-rake gitlab:check SANITIZE=true)
(For installations from source run and paste the output of:
sudo -u git -H bundle exec rake gitlab:check RAILS_ENV=production SANITIZE=true)
(we will only investigate if the tests are passing)

Possible fixes

Patch release information for backports

If the bug fix needs to be backported in a patch release to a version under the maintenance policy, please follow the steps on the patch release runbook for GitLab engineers.

Refer to the internal "Release Information" dashboard for information about the next patch release, including the targeted versions, expected release date, and current status.

High-severity bug remediation

To remediate high-severity issues requiring an internal release for single-tenant SaaS instances, refer to the internal release process for engineers.